A curated list of high-quality instructions, agents, prompts, and toolkits for mastering GitHub Copilot.

• What Are These Resources?
• How to Use
• Repository Structure
• Resources
  • Prompts
  • Instructions
  • Agents
  • Toolkits
• Contributing
• License
• Contributors

This repository contains a toolkit of configuration files that enhance and customize your GitHub Copilot experience.

• Instructions (.instructions.md): Provide contextual guidance for Copilot's behavior. They are perfect for setting project-specific rules, like code style or review guidelines.
• Prompts (.prompt.md): Reusable, shareable prompts that can be invoked with a / command in Copilot Chat. They help you perform common tasks quickly and consistently.
• Agents (.agent.md): Custom "personalities" or expert agents for Copilot Chat. You can create agents like a "Security Expert" or a "Refactoring Specialist" to get more focused answers.
• Toolkits (.toolkit.yml): Bundles of prompts, instructions, and agents that can be shared and used together.

To use any of the resources from this toolkit in your own project, start with these steps:

1. Browse the catalog below and pick the prompts, instructions, agents, or toolkits that fit your workflow.
2. Copy the file into your repository's .github/copilot/ directory (create it if it doesn't exist yet).
3. Customize the front matter and any placeholder content so the resource matches your project or team guidelines.
4. Commit and push the changes, then reopen Copilot Chat to start using your new configuration.

The directory structure should look like this:

.github/
└── copilot/
    ├── prompts/
    │   └── example.prompt.md
    ├── instructions/
    │   └── style-guide.instructions.md
    ├── agents/
    │   └── refactoring-specialist.agent.md
  └── toolkits/
    └── team-starter.toolkit.yml

• prompts/ – Shareable prompt files ready to drop into Copilot Chat.
• instructions/ – Behavioral guardrails that tune Copilot for specific projects or workflows.
• agents/ – Persona definitions that transform Copilot into focused specialists.
• toolkits/ – Bundles of prompts, instructions, and agents for quick onboarding.
• scripts/ – Helper scripts for generating README overviews and validating toolkits.

Each top-level directory includes (or will include) focused README files with extra guidance and examples.

Reusable /slash commands for Copilot Chat. Browse the prompts/ folder to copy existing prompts or submit your own via the contribution guidelines.

Project or domain-specific rules that keep Copilot aligned with your standards. Drop files from instructions/ into .github/copilot/ to make them active.

Custom personas—like "Security Expert" or "Refactoring Specialist"—that reshape Copilot’s responses. Find them in agents/.

Curated bundles of prompts, instructions, and agents you can import all at once. Explore the toolkits/ folder as it grows.

• – Focused, task-specific prompts for generating code, documentation, and solving specific problems.
• – Comprehensive coding standards and best practices that apply to specific file patterns or entire projects.
• – Specialized AI personas and conversation modes for different roles and contexts.
• – Curated toolkits of related prompts, instructions, and agents organized around specific themes and workflows.

Need inspiration?

• Browse README.prompts.md, README.instructions.md, and README.agents.md for curated highlights as the catalog expands.
• Check the toolkits/ directory for ready-to-use bundles when onboarding new teammates.
• Run npm run toolkit-validate to confirm toolkit manifests stay in sync after edits.

We welcome new resources, improvements, and documentation updates:

1. Read the Code of Conduct to keep contributions friendly and inclusive.
2. Review existing resource conventions (front matter, naming, formatting) before proposing changes.
3. Open an issue or submit a pull request with your new prompt, instruction, agent, or toolkit.
4. Update the relevant README files or scripts if your change adds new capabilities.

If you’re unsure where to start, check open issues or propose a new idea—maintainers are happy to help.

This project is licensed under the MIT License.

Thanks to everyone contributing new Copilot superpowers! This project follows the all-contributors specification—run npx all-contributors add to recognize new collaborators.