diff --git a/README.md b/README.md index 9c374261b..4a5068f0d 100644 --- a/README.md +++ b/README.md @@ -1,159 +1,47 @@ # ๐Ÿค– Awesome GitHub Copilot [![Powered by Awesome Copilot](https://img.shields.io/badge/Powered_by-Awesome_Copilot-blue?logo=githubcopilot)](https://aka.ms/awesome-github-copilot) [![GitHub contributors from allcontributors.org](https://img.shields.io/github/all-contributors/github/awesome-copilot?color=ee8449)](#contributors-) +A community-created collection of custom agents, instructions, skills, hooks, workflows, and plugins to supercharge your GitHub Copilot experience. -A community created collection of custom agents and instructions to supercharge your GitHub Copilot experience across different domains, languages, and use cases. +> [!TIP] +> **Explore the full collection on the website โ†’** [awesome-copilot.github.com](https://awesome-copilot.github.com) +> +> The website offers full-text search and filtering across 600+ resources, plus the [Tools](https://awesome-copilot.github.com/tools) section for MCP servers and developer tooling, and the [Learning Hub](https://awesome-copilot.github.com/learning-hub) for guides and tutorials. +> +> **Using this collection in an AI agent?** A machine-readable [`llms.txt`](https://awesome-copilot.github.com/llms.txt) is available with structured listings of all agents, instructions, and skills. -## ๐Ÿš€ What is Awesome GitHub Copilot? +## ๐Ÿ“– Learning Hub -This repository provides a comprehensive toolkit for enhancing GitHub Copilot with specialized: +New to GitHub Copilot customization? The **[Learning Hub](https://awesome-copilot.github.com/learning-hub)** on the website offers curated articles, walkthroughs, and reference material โ€” covering everything from core concepts like agents, skills, and instructions to hands-on guides for hooks, agentic workflows, MCP servers, and the Copilot coding agent. -- **๐Ÿ‘‰ [Awesome Agents](docs/README.agents.md)** - Specialized GitHub Copilot agents that integrate with MCP servers to provide enhanced capabilities for specific workflows and tools -- **๐Ÿ‘‰ [Awesome Instructions](docs/README.instructions.md)** - Comprehensive coding standards and best practices that apply to specific file patterns or entire projects -- **๐Ÿ‘‰ [Awesome Hooks](docs/README.hooks.md)** - Automated workflows triggered by specific events during development, testing, and deployment -- **๐Ÿ‘‰ [Awesome Agentic Workflows](docs/README.workflows.md)** - AI-powered repository automations that run coding agents in GitHub Actions with natural language instructions -- **๐Ÿ‘‰ [Awesome Skills](docs/README.skills.md)** - Self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized tasks -- **๐Ÿ‘‰ [Awesome Plugins](docs/README.plugins.md)** - Curated plugins of related agents and skills organized around specific themes and workflows -- **๐Ÿ‘‰ [Awesome Cookbook Recipes](cookbook/README.md)** - Practical, copy-paste-ready code snippets and real-world examples for working with GitHub Copilot tools and features +## What's in this repo -## ๐ŸŒŸ Featured Plugins +| Resource | Description | Browse | +|----------|-------------|--------| +| ๐Ÿค– [Agents](docs/README.agents.md) | Specialized Copilot agents that integrate with MCP servers | [All agents โ†’](https://awesome-copilot.github.com/agents) | +| ๐Ÿ“‹ [Instructions](docs/README.instructions.md) | Coding standards applied automatically by file pattern | [All instructions โ†’](https://awesome-copilot.github.com/instructions) | +| ๐ŸŽฏ [Skills](docs/README.skills.md) | Self-contained folders with instructions and bundled assets | [All skills โ†’](https://awesome-copilot.github.com/skills) | +| ๐Ÿ”Œ [Plugins](docs/README.plugins.md) | Curated bundles of agents and skills for specific workflows | [All plugins โ†’](https://awesome-copilot.github.com/plugins) | +| ๐Ÿช [Hooks](docs/README.hooks.md) | Automated actions triggered during Copilot agent sessions | [All hooks โ†’](https://awesome-copilot.github.com/hooks) | +| โšก [Agentic Workflows](docs/README.workflows.md) | AI-powered GitHub Actions automations written in markdown | [All workflows โ†’](https://awesome-copilot.github.com/workflows) | +| ๐Ÿณ [Cookbook](cookbook/README.md) | Copy-paste-ready recipes for working with Copilot APIs | โ€” | -Discover our curated plugins of agents and skills organized around specific themes and workflows. +## ๐Ÿ› ๏ธ Tools -| Name | Description | Items | Tags | -| ---- | ----------- | ----- | ---- | -| [Awesome Copilot](plugins/awesome-copilot/README.md) | 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](plugins/copilot-sdk/README.md) | 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](plugins/partners/README.md) | Custom agents that have been created by GitHub partners | 20 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance | +Looking at how to use Awesome Copilot? Check out the **[Tools section](https://awesome-copilot.github.com/tools)** of the website for MCP servers, editor integrations, and other developer tooling to get the most out of this collection. - -## How to Install Customizations - -To make it easy to add these customizations to your editor, we have created an [MCP Server](https://developer.microsoft.com/blog/announcing-awesome-copilot-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. - -[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/mcp/vscode) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/mcp/vscode-insiders) [![Install in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install-C16FDE?logo=visualstudio&logoColor=white)](https://aka.ms/awesome-copilot/mcp/vs) - -
-Show MCP Server JSON configuration - -```json -{ - "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`](https://awesome-copilot.github.com/llms.txt) file following the [llmstxt.org](https://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: +## Install a Plugin ```bash copilot plugin marketplace add github/awesome-copilot -``` - -Then install any plugin: - -```bash copilot plugin install @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](https://github.github.com/gh-aw) 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](CONTRIBUTING.md) 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](AGENTS.md) for detailed technical guidance on development workflows, setup commands, and contribution standards. - -### Quick Contribution Guide - -1. Follow our file naming conventions and frontmatter requirements -2. Test your contributions thoroughly -3. Update the appropriate README tables -4. Submit a pull request with a clear description - -## ๐Ÿ“– Repository Structure - -```plaintext -โ”œโ”€โ”€ 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](LICENSE) file for details. - -## ๐Ÿ›ก๏ธ Security & Support - -- **Security Issues**: Please see our [Security Policy](SECURITY.md) -- **Support**: Check our [Support Guide](SUPPORT.md) for getting help -- **Code of Conduct**: We follow the [Contributor Covenant](CODE_OF_CONDUCT.md) - -## โ„น๏ธ 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. +## Contributing ---- +See [CONTRIBUTING.md](CONTRIBUTING.md) ยท [AGENTS.md](AGENTS.md) for AI agent guidance ยท [Security](SECURITY.md) ยท [Code of Conduct](CODE_OF_CONDUCT.md) -**Ready to supercharge your coding experience?** Start exploring our [instructions](docs/README.instructions.md), [hooks](docs/README.hooks.md), [skills](docs/README.skills.md), [agentic workflows](docs/README.workflows.md), and [custom agents](docs/README.agents.md)! +> The customizations here are sourced from third-party developers. Please inspect any agent and its documentation before installing. ## Contributors โœจ