copilot-docs — Claude Code skill: GitHub Copilot instructions
copilot-docs drafts the .github/copilot-instructions.md file that tells GitHub Copilot your stack, code style and repo conventions.
no license ★ 301 updated 2026-10-23
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a claude-codeWhat copilot-docs does
The skill walks you through a repo-level instruction file for GitHub Copilot. It ships ready-made sections: project context, code standards, naming, testing. Also API response shapes and a short list of things to keep out of the code. Samples use a Next.js, TypeScript, Prisma and Vitest setup, so read them as a structure to fill with your own stack.
Location is the one hard rule. Copilot reads .github/copilot-instructions.md and nothing else; a copy at the repo root does nothing at all.
The rest is content work. Describe the folders you actually have, write down the conventions the team already follows without saying so out loud. The skill ends with pointers to GitHub and VS Code documentation on configuring Copilot.
What it helps with
- Draft
.github/copilot-instructions.mdfor an existing repo - Spell out the stack and folder layout for Copilot
- Pin down naming and error-handling rules
- Show the expected API response shape and Zod validation
- List the patterns that should stay out of the codebase
Example prompts for the agent
- Write
.github/copilot-instructions.mdfor this repo — Next.js, TypeScript, Prisma - Add a testing section for Vitest to the Copilot instructions
- Rewrite the code standards block for a Vue project instead of React
How to install copilot-docs
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a claude-code2Manually: put the files in place
~/.claude/skills/copilot-docs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/copilot-docs/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a codex2Manually: put the files in place
.agents/skills/copilot-docs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a cursor2Manually: put the files in place
.cursor/skills/copilot-docs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills skills/copilot-docs2Manually: put the files in place
.github/skills/copilot-docs/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/copilot-docsManually: put the files in place
.devin/skills/copilot-docs/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about copilot-docs
How do I install copilot-docs in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill copilot-docs -a claude-code. The skill ends up at ~/.claude/skills/copilot-docs/SKILL.md.
What does copilot-docs do?
It helps you write the GitHub Copilot instruction file: project context, code style, naming, tests and API response templates. The blocks come ready to adapt to your repo.
Where should the instructions file live?
In .github/copilot-instructions.md only. Copilot will not pick it up from the repository root.