Setup Agent Documents for GitHub Copilot

setup-agent-documents is a GitHub Copilot skill that configures AI-development documents through chat. It inspects the target repository, asks contextual questions one at a time, saves resumable state, shows the proposed output, and writes only after confirmation.

Install the skill

From the root of the project you want to configure, run:

npx setup-agent-documents

The command installs only these Copilot files in the current project:

.github/
├── prompts/setup-agent-documents.prompt.md
└── skills/setup-agent-documents/

It does not need flags, dependencies, or an API key. It never overwrites an existing installed skill or prompt.

Run the workflow

Open GitHub Copilot Chat in the target project and enter:

/setup-agent-documents

In VS Code, enable workspace prompt files with "chat.promptFiles": true if the command does not appear in the chat command list.

After you confirm the generated file plan, the skill writes the resolved answers directly into the target project. The repository-wide files are AGENTS.md and .github/copilot-instructions.md; scoped guidance goes in .github/instructions/*.instructions.md, local AGENTS.md files sit next to the code they govern, and reusable tasks are .github/prompts/*.prompt.md. No .ai-harness wrapper directory is created.

Development

Run the bundled installer locally from this repository:

node bin/setup-agent-documents.mjs

Run npm run validate before publishing. See USAGE.md for the full workflow and docs/architecture.md for the design.