A curated library of GitHub Copilot customization assets (agents, skills, prompts, and instruction files) designed to be reusable across projects.
If you want Copilot to behave more like a teammate with strong opinions—this repo is the toolbox.
- Agents: role definitions with tool access and operating rules
- Skills: progressively-loaded task toolkits (docs, scripts, templates)
- Prompt files: reusable slash commands (structured playbooks)
- Instruction files: authoring rules and quality bars
Primary documentation lives in docs/README.md.
- Browse the catalog: docs/reference/catalog.md
- Pick an agent or skill you want to try.
- Integrate using one of the options below:
- Shared library (recommended): keep this repo as the source of truth and copy/sync assets into other repos as needed.
- Vendor into a repo: copy
.github/agents/,.github/skills/,.github/prompts/,.github/instructions/into the target repository. - Personal (user-wide) skills: install skills into
~/.github/skills/<skill-name>/(see the skill guidelines for supported locations).
More detail: docs/guides/getting-started.md
More detail: docs/architecture/agent-workflow.md
flowchart LR
U[User request] --> C[Copilot Chat]
subgraph Assets[Customization assets]
A[Agents\n.github/agents/*.agent.md]
I[Instructions\n.github/instructions/*.instructions.md]
S[Skills\n.github/skills/<skill>/SKILL.md]
P[Prompts\n.github/prompts/*.prompt.md]
end
C -->|selects or infers| A
C -->|applies by applyTo globs| I
C -->|discovers by name+description| S
C -->|runs slash command| P
Full explanation: docs/architecture/copilot-customization-model.md
| Path | What it contains |
|---|---|
| .github/agents/ | Custom agent definitions (*.agent.md) |
| .github/skills/ | Skill packs (each folder contains a SKILL.md) |
| .github/prompts/ | Prompt files (*.prompt.md) |
| .github/instructions/ | Authoring rules / quality bars (*.instructions.md) |
| docs/ | Project documentation (guides, architecture, reference) |
If you’re adding new assets, start with the repo’s authoring rules:
- Agents: .github/instructions/agents.instructions.md
- Skills: .github/instructions/agent-skills.instructions.md
- Prompts: .github/instructions/prompt.instructions.md
- Instructions: .github/instructions/instructions.instructions.md
Contributor-friendly overview: docs/guides/authoring.md
See LICENSE.