# copilot-docs

copilot-docs drafts the .github/copilot-instructions.md file that tells GitHub Copilot your stack, code style and repo conventions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 301 repo stars
- Author: hoodini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/copilot-docs/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/copilot-docs

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/copilot-docs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/copilot-docs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/copilot-docs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/copilot-docs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoodini/ai-agents-skills skills/copilot-docs
```

2. **Manually: put the files in place**
- File: `.github/skills/copilot-docs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill copilot-docs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/copilot-docs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/copilot-docs/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/copilot-docs/SKILL.md

## When to use it
- Draft `.github/copilot-instructions.md` for 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
- Write `.github/copilot-instructions.md` for 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

## Similar
- [update-docs-on-code-change](https://affpapa.org/en/nevibecode/rules/update-docs-on-code-change.md) — rule · ★ 41430 repo stars
- [github-copilot-starter](https://affpapa.org/en/nevibecode/skills/github-copilot-starter.md) — skill · 8900 installs
- [copilot-tracking](https://affpapa.org/en/nevibecode/rules/copilot-tracking.md) — rule · ★ 1627 repo stars
- [slack-docs](https://affpapa.org/en/nevibecode/skills/slack-docs.md) — skill · 4300 installs
- [docs-write](https://affpapa.org/en/nevibecode/skills/docs-write.md) — skill · 2100 installs
- [game-docs](https://affpapa.org/en/nevibecode/skills/game-docs.md) — skill · 2000 installs

From the same set: [hoodini/ai-agents-skills](https://affpapa.org/en/nevibecode/by/hoodini/ai-agents-skills.md) — 34 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
