fca5de1f6a
* Add advanced search reference with query syntax guide Covers search qualifiers, boolean logic, date ranges, missing metadata filters, common patterns, and when to use search vs list_issues. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add issue fields search support to search and issue-fields references - Add Advanced Search Mode section to search.md covering field: qualifier, has:field: syntax, REST advanced_search=true, and GraphQL ISSUE_ADVANCED - Add Searching by Field Values section to issue-fields.md with REST/GraphQL examples and qualifier reference table - Note MCP search_issues limitation (no advanced_search support) - Update SKILL.md capability table to mention issue field filters Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify three search approaches: list_issues vs search_issues vs advanced search Replace the simple two-column comparison with a capability matrix showing what each approach supports (field filters, boolean logic, scope, etc.) and a decision guide for when to use each one. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix issue field search syntax: use dot notation (field.name:value) The colon notation (field:Name:Value) is silently ignored by the API. The correct syntax is dot notation (field.priority:P0) which works in REST (advanced_search=true), GraphQL (ISSUE_ADVANCED), and web UI. Also supports has:field.name, no:field.name, and date comparisons. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix github-issues skill: correct MCP tools and add gh api workflows The skill listed 5 MCP tools that don't exist (create_issue, update_issue, get_issue, add_issue_comment, list_issue_types), causing tool-not-found errors when agents tried to follow the skill instructions. Changes: - Split tools table into MCP (read ops) and CLI/API (write ops) - Add gh api commands for creating, updating, commenting on issues - Document that gh issue create doesn't support --type flag - Add GraphQL query for discovering issue types - Remove redundant [Bug]/[Feature] title prefixes (use type param instead) - Update examples to use gh api instead of non-existent MCP tools Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix sub-issues reference: add gh api examples and integer gotcha The sub_issue_id parameter requires an integer but gh api -f sends strings, causing 422 errors. Updated all REST examples to use --input with raw JSON. Also added: - Recommended two-step workflow (create issue, then link) - Explicit warning about -f vs --input for integer params - Proper gh api command syntax instead of raw HTTP notation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address PR review: fix search docs accuracy and broken link - Fix misleading claim about full boolean logic support (implicit AND only) - Remove sort:updated from query example (it's an API param, not a qualifier) - Clarify -linked:pr comment to avoid confusion with authoring status - Fix relative link in issue-fields.md (sibling file, not nested path) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Improve projects reference: scope warning, gh api examples, issue-side queries From hands-on usage: hit INSUFFICIENT_SCOPES trying to update project status because token had read:project but not project write scope. Added: - OAuth scope requirements table with gh auth refresh workaround - How to find an issue's project item ID (query from issue side) - All GraphQL examples now use gh api graphql (copy-paste ready) - End-to-end example: set issue status to In Progress Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add images-in-issues reference: hosting methods, pitfalls, screenshots Documents three approaches for embedding images in issue comments via CLI: Contents API with github.com/raw/ URLs, browser drag-drop for permanent user-attachments URLs, and gist hosting limitations. Includes puppeteer screenshot recipe and comparison table. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update README.skills.md with images reference Run npm run build to regenerate skill listing. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix issue-fields search: add GraphQL bulk query, caveat search syntax The field.name:value search qualifier is unreliable via API (returns 0 results even when matching issues exist). Added a recommended GraphQL approach that fetches issues and filters by issueFieldValues client-side. Documented the correct IssueFieldSingleSelectValue schema (name, not value). Marked search qualifier syntax as experimental with a reliability warning. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs(github-issues): improve project discovery guidance The projectsV2 query param does keyword search, not exact match, and sorts by recency. For large orgs like github, common words like 'issue' return 400+ results and bury the target project. Added a priority-ordered discovery strategy: 1. Direct lookup by number (instant) 2. Reverse lookup from a known issue's projectItems (most reliable) 3. GraphQL name search with client-side jq filtering (fallback) 4. MCP tool (small orgs only) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
🤖 Awesome GitHub Copilot
A community created collection of custom agents and instructions to supercharge your GitHub Copilot experience across different domains, languages, and use cases.
🚀 What is Awesome GitHub Copilot?
This repository provides a comprehensive toolkit for enhancing GitHub Copilot with specialized:
- 👉 Awesome Agents - Specialized GitHub Copilot agents that integrate with MCP servers to provide enhanced capabilities for specific workflows and tools
- 👉 Awesome Instructions - Comprehensive coding standards and best practices that apply to specific file patterns or entire projects
- 👉 Awesome Hooks - Automated workflows triggered by specific events during development, testing, and deployment
- 👉 Awesome Agentic Workflows - AI-powered repository automations that run coding agents in GitHub Actions with natural language instructions
- 👉 Awesome Skills - Self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized tasks
- 👉 Awesome Plugins - Curated plugins of related agents and skills organized around specific themes and workflows
- 👉 Awesome Cookbook Recipes - Practical, copy-paste-ready code snippets and real-world examples for working with GitHub Copilot tools and features
🌟 Featured Plugins
Discover our curated plugins of agents and skills organized around specific themes and workflows.
| Name | Description | Items | Tags |
|---|---|---|---|
| Awesome Copilot | Meta skills that help you discover and generate curated GitHub Copilot agents, collections, instructions, and skills. | 5 items | github-copilot, discovery, meta, prompt-engineering, agents |
| Copilot SDK | Build applications with the GitHub Copilot SDK across multiple programming languages. Includes comprehensive instructions for C#, Go, Node.js/TypeScript, and Python to help you create AI-powered applications. | 5 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot |
| Partners | Custom agents that have been created by GitHub partners | 20 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance |
How to Install Customizations
To make it easy to add these customizations to your editor, we have created an MCP Server that provides functionality for searching and installing instructions, agents, and skills directly from this repository. You'll need to have Docker installed and running to run the MCP server locally.
Show MCP Server JSON configuration
{
"servers": {
"awesome-copilot": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:latest"
]
}
}
}
📄 llms.txt
An llms.txt file following the llmstxt.org specification is available on the GitHub Pages site. This machine-readable file makes it easy for Large Language Models to discover and understand all available agents, instructions, and skills, providing a structured overview of the repository's resources with names and descriptions.
🔧 How to Use
🔌 Plugins
Plugins are installable packages that bundle related agents and skills, making it easy to install a curated set of resources.
Installing Plugins
First, add the Awesome Copilot marketplace to your Copilot CLI:
copilot plugin marketplace add github/awesome-copilot
Then install any plugin:
copilot plugin install <plugin-name>@awesome-copilot
Alternatively, you can use the /plugin command within a Copilot chat session to browse and install plugins interactively.
🤖 Custom Agents
Custom agents can be used in Copilot coding agent (CCA), VS Code, and Copilot CLI (coming soon). For CCA, when assigning an issue to Copilot, select the custom agent from the provided list. In VS Code, you can activate the custom agent in the agents session, alongside built-in agents like Plan and Agent.
🎯 Skills
Skills are self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized tasks. They can be accessed through the GitHub Copilot interface or installed via plugins.
📋 Instructions
Instructions automatically apply to files based on their patterns and provide contextual guidance for coding standards, frameworks, and best practices.
🪝 Hooks
Hooks enable automated workflows triggered by specific events during GitHub Copilot coding agent sessions (like sessionStart, sessionEnd, userPromptSubmitted). They can automate tasks like logging, auto-committing changes, or integrating with external services.
⚡ Agentic Workflows
Agentic Workflows are AI-powered repository automations that run coding agents in GitHub Actions. Defined in markdown with natural language instructions, they enable event-triggered and scheduled automation — from issue triage to daily reports.
🎯 Why Use Awesome GitHub Copilot?
- Productivity: Pre-built agents and instructions save time and provide consistent results.
- Best Practices: Benefit from community-curated coding standards and patterns.
- Specialized Assistance: Access expert-level guidance through specialized custom agents.
- Continuous Learning: Stay updated with the latest patterns and practices across technologies.
🤝 Contributing
We welcome contributions! Please see our Contributing Guidelines for details on how to:
- Add new instructions, hooks, workflows, agents, or skills
- Improve existing content
- Report issues or suggest enhancements
For AI coding agents working with this project, refer to AGENTS.md for detailed technical guidance on development workflows, setup commands, and contribution standards.
Quick Contribution Guide
- Follow our file naming conventions and frontmatter requirements
- Test your contributions thoroughly
- Update the appropriate README tables
- Submit a pull request with a clear description
📖 Repository Structure
├── instructions/ # Coding standards and best practices (.instructions.md)
├── agents/ # AI personas and specialized modes (.agent.md)
├── hooks/ # Automated hooks for Copilot coding agent sessions
├── workflows/ # Agentic Workflows for GitHub Actions automation
├── plugins/ # Installable plugins bundling related items
├── scripts/ # Utility scripts for maintenance
└── skills/ # AI capabilities for specialized tasks
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🛡️ Security & Support
- Security Issues: Please see our Security Policy
- Support: Check our Support Guide for getting help
- Code of Conduct: We follow the Contributor Covenant
ℹ️ Disclaimer
The customizations in this repository are sourced from and created by third-party developers. GitHub does not verify, endorse, or guarantee the functionality or security of these agents. Please carefully inspect any agent and its documentation before installing to understand permissions it may require and actions it may perform.
Ready to supercharge your coding experience? Start exploring our instructions, hooks, skills, agentic workflows, and custom agents!
Contributors ✨
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
📚 Additional Resources
- VS Code Copilot Customization Documentation - Official Microsoft documentation
- GitHub Copilot Chat Documentation - Complete chat feature guide
- VS Code Settings - General VS Code configuration guide
™️ Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.