From 92dbe54cc61a791e9aad5a1b7324b32441cb5340 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Fri, 23 Jan 2026 10:51:55 +1100 Subject: [PATCH] Cleaning up some legacy around chat modes --- .github/copilot-instructions.md | 33 ++++++--- .github/pull_request_template.md | 8 +-- CONTRIBUTING.md | 27 ++++--- README.md | 9 ++- collections/awesome-copilot.collection.yml | 4 +- collections/awesome-copilot.md | 5 +- docs/README.collections.md | 2 +- docs/README.prompts.md | 1 - eng/update-readme.mjs | 10 +-- package.json | 4 +- ...awesome-github-copilot-chatmodes.prompt.md | 71 ------------------- 11 files changed, 54 insertions(+), 120 deletions(-) delete mode 100644 prompts/suggest-awesome-github-copilot-chatmodes.prompt.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 93311f83a..4ebf9c971 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -2,20 +2,20 @@ The following instructions are only to be applied when performing a code review. ## README updates -- [ ] The new file should be added to the `README.md`. +- [ ] The new file should be added to the `docs/README..md`. ## Prompt file guide **Only apply to files that end in `.prompt.md`** - [ ] The prompt has markdown front matter. -- [ ] The prompt has a `mode` field specified of either `agent` or `ask`. +- [ ] The prompt has a `agent` field specified of either `agent`, `ask`, or `Plan`. - [ ] The prompt has a `description` field. - [ ] The `description` field is not empty. -- [ ] The `description` field value is wrapped in single quotes. - [ ] The file name is lower case, with words separated by hyphens. - [ ] Encourage the use of `tools`, but it's not required. - [ ] Strongly encourage the use of `model` to specify the model that the prompt is optimised for. +- [ ] Strongly encourage the use of `name` to set the name for the prompt. ## Instruction file guide @@ -24,21 +24,20 @@ The following instructions are only to be applied when performing a code review. - [ ] The instruction has markdown front matter. - [ ] The instruction has a `description` field. - [ ] The `description` field is not empty. -- [ ] The `description` field value is wrapped in single quotes. - [ ] The file name is lower case, with words separated by hyphens. - [ ] The instruction has an `applyTo` field that specifies the file or files to which the instructions apply. If they wish to specify multiple file paths they should formated like `'**.js, **.ts'`. -## Chat Mode file guide +## Agent file guide **Only apply to files that end in `.agent.md`** -- [ ] The chat mode has markdown front matter. -- [ ] The chat mode has a `description` field. +- [ ] The agent has markdown front matter. +- [ ] The agent has a `description` field. - [ ] The `description` field is not empty. -- [ ] The `description` field value is wrapped in single quotes. - [ ] The file name is lower case, with words separated by hyphens. - [ ] Encourage the use of `tools`, but it's not required. -- [ ] Strongly encourage the use of `model` to specify the model that the chat mode is optimised for. +- [ ] Strongly encourage the use of `model` to specify the model that the agent is optimised for. +- [ ] Strongly encourage the use of `name` to set the name for the agent. ## Agent Skills guide @@ -55,3 +54,19 @@ The following instructions are only to be applied when performing a code review. - [ ] The folder name is lower case, with words separated by hyphens. - [ ] Any bundled assets (scripts, templates, data files) are referenced in the SKILL.md instructions. - [ ] Bundled assets are reasonably sized (under 5MB per file). + +## Collection file guide + +**Only apply to files that end in `.collection.yml`** + +- [ ] The collection has a `name` field. +- [ ] The collection has a `description` field. +- [ ] The `description` field is not empty. +- [ ] The collection has a `tags` field. +- [ ] The file name is lower case, with words separated by hyphens. +- [ ] Each item in the collection has a `path` field. +- [ ] Each item in the collection has a `kind` field. +- [ ] The `kind` field value is one of: `prompt`, `instruction`, `agent`, or `skill`. +- [ ] The collection does not include duplicate items. +- [ ] The collection does not reference non-existent files. +- [ ] Each item can have an optional `usage` field describing when to use the item. diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index b9003984b..72c6b4032 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,10 +1,10 @@ ## Pull Request Checklist - [ ] I have read and followed the [CONTRIBUTING.md](https://github.com/github/awesome-copilot/blob/main/CONTRIBUTING.md) guidelines. -- [ ] My contribution adds a new instruction, prompt, or chat mode file in the correct directory. +- [ ] My contribution adds a new instruction, prompt, agent, or skill file in the correct directory. - [ ] The file follows the required naming convention. - [ ] The content is clearly structured and follows the example format. -- [ ] I have tested my instructions, prompt, or chat mode with GitHub Copilot. +- [ ] I have tested my instructions, prompt, agent, or skill with GitHub Copilot. - [ ] I have run `npm start` and verified that `README.md` is up to date. --- @@ -19,10 +19,10 @@ - [ ] New instruction file. - [ ] New prompt file. -- [ ] New chat mode file. +- [ ] New agent file. - [ ] New collection file. - [ ] New skill file. -- [ ] Update to existing instruction, prompt, chat mode, collection or skill. +- [ ] Update to existing instruction, prompt, agent, collection or skill. - [ ] Other (please specify): --- diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2a11bd47d..e2e87f173 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -61,27 +61,26 @@ Your goal is to... - Include examples where helpful ``` -### Adding Chat Modes +### Adding an Agent -Chat modes are specialized configurations that transform GitHub Copilot Chat into domain-specific assistants or personas for particular development scenarios. +Agents are specialized configurations that transform GitHub Copilot Chat into domain-specific assistants or personas for particular development scenarios. -1. **Create your chat mode file**: Add a new `.agent.md` file in the `agents/` directory +1. **Create your agent file**: Add a new `.agent.md` file in the `agents/` directory 2. **Follow the naming convention**: Use descriptive, lowercase filenames with hyphens and the `.agent.md` extension (e.g., `react-performance-expert.agent.md`) 3. **Include frontmatter**: Add metadata at the top of your file with required fields -4. **Define the persona**: Create a clear identity and expertise area for the chat mode -5. **Test your chat mode**: Ensure the chat mode provides helpful, accurate responses in its domain +4. **Define the persona**: Create a clear identity and expertise area for the agent +5. **Test your agent**: Ensure the agent provides helpful, accurate responses in its domain -#### Example chat mode format +#### Example agent format ```markdown --- -description: 'Brief description of the chat mode and its purpose' +description: 'Brief description of the agent and its purpose' model: 'gpt-5' tools: ['codebase', 'terminalCommand'] +name: 'My Agent Name' --- -# Chat Mode Title - You are an expert [domain/role] with deep knowledge in [specific areas]. ## Your Expertise @@ -114,7 +113,7 @@ Skills are self-contained folders in the `skills/` directory that include a `SKI ### Adding Collections -Collections group related prompts, instructions, and chat modes around specific themes or workflows, making it easier for users to discover and adopt comprehensive toolkits. +Collections group related prompts, instructions, agents, and skills around specific themes or workflows, making it easier for users to discover and adopt comprehensive toolkits. 1. **Create your collection manifest**: Add a new `.collection.yml` file in the `collections/` directory 2. **Follow the naming convention**: Use descriptive, lowercase filenames with hyphens (e.g., `python-web-development.collection.yml`) @@ -142,17 +141,17 @@ items: kind: prompt - path: instructions/my-instructions.instructions.md kind: instruction - - path: agents/my-chatmode.agent.md + - path: agents/my-custom.agent.md kind: agent usage: | recommended # or "optional" if not essential to the workflow - This chat mode requires the following instructions/prompts/MCPs: + This agent requires the following instructions/prompts/MCPs: - Instruction 1 - Prompt 1 - MCP 1 - This chat mode is ideal for... + This agent is ideal for... - Use case 1 - Use case 2 @@ -255,7 +254,7 @@ We welcome many kinds of contributions, including the custom categories below: | --- | --- | :---: | | **Instructions** | Custom instruction sets that guide GitHub Copilot behavior | 🧭 | | **Prompts** | Reusable or one-off prompts for GitHub Copilot | ⌨️ | -| **Agents (Chat Modes)** | Defined GitHub Copilot roles or personalities | 🎭 | +| **Agents** | Defined GitHub Copilot roles or personalities | 🎭 | | **Skills** | Specialized knowledge of a task for GitHub Copilot | 🧰 | | **Collections** | Curated bundles of related prompts, agents, or instructions | 🎁 | diff --git a/README.md b/README.md index 4017e0eac..2f6e0d269 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ This repository provides a comprehensive toolkit for enhancing GitHub Copilot wi - **👉 [Awesome Prompts](docs/README.prompts.md)** - Focused, task-specific prompts for generating code, documentation, and solving specific problems - **👉 [Awesome Instructions](docs/README.instructions.md)** - Comprehensive coding standards and best practices that apply to specific file patterns or entire projects - **👉 [Awesome Skills](docs/README.skills.md)** - Self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized tasks -- **👉 [Awesome Collections](docs/README.collections.md)** - Curated collections of related prompts, instructions, and chat modes organized around specific themes and workflows +- **👉 [Awesome Collections](docs/README.collections.md)** - Curated collections of related prompts, instructions, agents, and skills organized around specific themes and workflows ## 🌟 Featured Collections @@ -20,14 +20,14 @@ Discover our curated collections of prompts, instructions, and agents organized | Name | Description | Items | Tags | | ---- | ----------- | ----- | ---- | -| [Awesome Copilot](collections/awesome-copilot.md) | Meta prompts that help you discover and generate curated GitHub Copilot chat modes, collections, instructions, prompts, and agents. | 6 items | github-copilot, discovery, meta, prompt-engineering, agents | +| [Awesome Copilot](collections/awesome-copilot.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills. | 5 items | github-copilot, discovery, meta, prompt-engineering, agents | | [Copilot SDK](collections/copilot-sdk.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. | 4 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot | | [Partners](collections/partners.md) | Custom agents that have been created by GitHub partners | 20 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance | ## MCP Server -To make it easy to add these customizations to your editor, we have created a [MCP Server](https://developer.microsoft.com/blog/announcing-awesome-copilot-mcp-server) that provides a prompt for searching and installing prompts, instructions, and chat modes directly from this repository. You'll need to have Docker installed and running to run the server. +To make it easy to add these customizations to your editor, we have created a [MCP Server](https://developer.microsoft.com/blog/announcing-awesome-copilot-mcp-server) that provides a prompt for searching and installing prompts, instructions, agents, and skills directly from this repository. You'll need to have Docker installed and running to run the server. [![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) @@ -82,7 +82,7 @@ Instructions automatically apply to files based on their patterns and provide co We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to: -- Add new prompts, instructions, or chat modes +- Add new prompts, instructions, agents, or skills - Improve existing content - Report issues or suggest enhancements @@ -399,7 +399,6 @@ This project follows the [all-contributors](https://github.com/all-contributors/ - [VS Code Copilot Customization Documentation](https://code.visualstudio.com/docs/copilot/copilot-customization) - Official Microsoft documentation - [GitHub Copilot Chat Documentation](https://code.visualstudio.com/docs/copilot/chat/copilot-chat) - Complete chat feature guide -- [Custom Chat Modes](https://code.visualstudio.com/docs/copilot/chat/chat-modes) - Advanced chat configuration - [VS Code Settings](https://code.visualstudio.com/docs/getstarted/settings) - General VS Code configuration guide ## ™️ Trademarks diff --git a/collections/awesome-copilot.collection.yml b/collections/awesome-copilot.collection.yml index 43c360088..ea573351c 100644 --- a/collections/awesome-copilot.collection.yml +++ b/collections/awesome-copilot.collection.yml @@ -1,10 +1,8 @@ id: awesome-copilot name: Awesome Copilot -description: "Meta prompts that help you discover and generate curated GitHub Copilot chat modes, collections, instructions, prompts, and agents." +description: "Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills." tags: [github-copilot, discovery, meta, prompt-engineering, agents] items: - - path: prompts/suggest-awesome-github-copilot-chatmodes.prompt.md - kind: prompt - path: prompts/suggest-awesome-github-copilot-collections.prompt.md kind: prompt - path: prompts/suggest-awesome-github-copilot-instructions.prompt.md diff --git a/collections/awesome-copilot.md b/collections/awesome-copilot.md index 371283ef0..0dbfd9fbd 100644 --- a/collections/awesome-copilot.md +++ b/collections/awesome-copilot.md @@ -1,6 +1,6 @@ # Awesome Copilot -Meta prompts that help you discover and generate curated GitHub Copilot chat modes, collections, instructions, prompts, and agents. +Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills. **Tags:** github-copilot, discovery, meta, prompt-engineering, agents @@ -11,9 +11,8 @@ Meta prompts that help you discover and generate curated GitHub Copilot chat mod | [Meta Agentic Project Scaffold](../agents/meta-agentic-project-scaffold.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmeta-agentic-project-scaffold.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fmeta-agentic-project-scaffold.agent.md) | Agent | Meta agentic project creation assistant to help users create and manage project workflows effectively. | | | [Suggest Awesome GitHub Copilot Collections](../prompts/suggest-awesome-github-copilot-collections.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-collections.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-collections.prompt.md) | Prompt | Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates. | | | [Suggest Awesome GitHub Copilot Custom Agents](../prompts/suggest-awesome-github-copilot-agents.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-agents.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-agents.prompt.md) | Prompt | Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates. | | -| [Suggest Awesome GitHub Copilot Custom Chat Modes](../prompts/suggest-awesome-github-copilot-chatmodes.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-chatmodes.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-chatmodes.prompt.md) | Prompt | Suggest relevant GitHub Copilot Custom Chat Modes files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom chat modes in this repository. | | | [Suggest Awesome GitHub Copilot Instructions](../prompts/suggest-awesome-github-copilot-instructions.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-instructions.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-instructions.prompt.md) | Prompt | Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates. | | | [Suggest Awesome GitHub Copilot Prompts](../prompts/suggest-awesome-github-copilot-prompts.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-prompts.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-prompts.prompt.md) | Prompt | Suggest relevant GitHub Copilot prompt files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing prompts in this repository, and identifying outdated prompts that need updates. | | --- -*This collection includes 6 curated items for **Awesome Copilot**.* \ No newline at end of file +*This collection includes 5 curated items for **Awesome Copilot**.* \ No newline at end of file diff --git a/docs/README.collections.md b/docs/README.collections.md index 9785b4abd..a1eba0df7 100644 --- a/docs/README.collections.md +++ b/docs/README.collections.md @@ -16,7 +16,7 @@ Curated collections of related prompts, instructions, and agents organized aroun | Name | Description | Items | Tags | | ---- | ----------- | ----- | ---- | -| [⭐ Awesome Copilot](../collections/awesome-copilot.md) | Meta prompts that help you discover and generate curated GitHub Copilot chat modes, collections, instructions, prompts, and agents. | 6 items | github-copilot, discovery, meta, prompt-engineering, agents | +| [⭐ Awesome Copilot](../collections/awesome-copilot.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills. | 5 items | github-copilot, discovery, meta, prompt-engineering, agents | | [⭐ Copilot SDK](../collections/copilot-sdk.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. | 4 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot | | [⭐ Partners](../collections/partners.md) | Custom agents that have been created by GitHub partners | 20 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance | | [Azure & Cloud Development](../collections/azure-cloud-development.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 18 items | azure, cloud, infrastructure, bicep, terraform, serverless, architecture, devops | diff --git a/docs/README.prompts.md b/docs/README.prompts.md index 541d5e715..7a1d04084 100644 --- a/docs/README.prompts.md +++ b/docs/README.prompts.md @@ -132,7 +132,6 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [SQL Performance Optimization Assistant](../prompts/sql-optimization.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsql-optimization.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsql-optimization.prompt.md) | Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance. | | [Suggest Awesome GitHub Copilot Collections](../prompts/suggest-awesome-github-copilot-collections.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-collections.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-collections.prompt.md) | Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates. | | [Suggest Awesome GitHub Copilot Custom Agents](../prompts/suggest-awesome-github-copilot-agents.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-agents.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-agents.prompt.md) | Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates. | -| [Suggest Awesome GitHub Copilot Custom Chat Modes](../prompts/suggest-awesome-github-copilot-chatmodes.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-chatmodes.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-chatmodes.prompt.md) | Suggest relevant GitHub Copilot Custom Chat Modes files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom chat modes in this repository. | | [Suggest Awesome GitHub Copilot Instructions](../prompts/suggest-awesome-github-copilot-instructions.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-instructions.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-instructions.prompt.md) | Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates. | | [Suggest Awesome GitHub Copilot Prompts](../prompts/suggest-awesome-github-copilot-prompts.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-prompts.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsuggest-awesome-github-copilot-prompts.prompt.md) | Suggest relevant GitHub Copilot prompt files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing prompts in this repository, and identifying outdated prompts that need updates. | | [Swift MCP Server Generator](../prompts/swift-mcp-server-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fswift-mcp-server-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fswift-mcp-server-generator.prompt.md) | Generate a complete Model Context Protocol server project in Swift using the official MCP Swift SDK package. | diff --git a/eng/update-readme.mjs b/eng/update-readme.mjs index 31e5c8890..b36d13513 100644 --- a/eng/update-readme.mjs +++ b/eng/update-readme.mjs @@ -579,7 +579,7 @@ function generateSkillsSection(skillsDir) { } /** - * Unified generator for chat modes & agents (future consolidation) + * Unified generator for agents (future consolidation) * @param {Object} cfg * @param {string} cfg.dir - Directory path * @param {string} cfg.extension - File extension to match (e.g. .agent.md, .agent.md) @@ -861,9 +861,7 @@ function generateCollectionReadme( const description = extractDescription(filePath) || "No description"; const typeDisplay = - item.kind === "chat-mode" - ? "Chat Mode" - : item.kind === "instruction" + item.kind === "instruction" ? "Instruction" : item.kind === "agent" ? "Agent" @@ -876,8 +874,6 @@ function generateCollectionReadme( const badgeType = item.kind === "instruction" ? "instructions" - : item.kind === "chat-mode" - ? "mode" : item.kind === "agent" ? "agent" : item.kind === "skill" @@ -949,7 +945,7 @@ function buildCollectionRow({ const safeUsage = formatTableCell(usageDescription); if (hasAgents) { - // Only agents currently have MCP servers; future migration may extend to chat modes. + // Only agents currently have MCP servers; const mcpServers = kind === "agent" ? extractMcpServerConfigs(filePath) : []; const mcpServerCell = diff --git a/package.json b/package.json index bf367d1a9..16c99fa6e 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "awesome-copilot", "version": "1.0.0", - "description": "Enhance your GitHub Copilot experience with community-contributed instructions, prompts, and chat modes", + "description": "Enhance your GitHub Copilot experience with community-contributed instructions, prompts, agents, and skills.", "main": "./eng/update-readme.js", "private": true, "scripts": { @@ -26,7 +26,7 @@ "ai", "prompts", "instructions", - "chat modes", + "skills", "agents" ], "author": "GitHub", diff --git a/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md b/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md deleted file mode 100644 index 054d3b266..000000000 --- a/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -agent: 'agent' -description: 'Suggest relevant GitHub Copilot Custom Chat Modes files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom chat modes in this repository.' -tools: ['edit', 'search', 'runCommands', 'runTasks', 'think', 'changes', 'testFailure', 'openSimpleBrowser', 'web/fetch', 'githubRepo', 'todos', 'search'] ---- - -# Suggest Awesome GitHub Copilot Custom Chat Modes - -Analyze current repository context and suggest relevant Custom Chat Modes files from the [GitHub awesome-copilot repository](https://github.com/github/awesome-copilot/blob/main/docs/README.chatmodes.md) that are not already available in this repository. Custom Chat Mode files are located in the [chatmodes](https://github.com/github/awesome-copilot/tree/main/chatmodes) folder of the awesome-copilot repository. - -## Process - -1. **Fetch Available Custom Chat Modes**: Extract Custom Chat Modes list and descriptions from [awesome-copilot README.chatmodes.md](https://github.com/github/awesome-copilot/blob/main/docs/README.chatmodes.md). Must use `#fetch` tool. -2. **Scan Local Custom Chat Modes**: Discover existing custom chat mode files in `.github/agents/` folder -3. **Extract Descriptions**: Read front matter from local custom chat mode files to get descriptions -4. **Analyze Context**: Review chat history, repository files, and current project needs -5. **Compare Existing**: Check against custom chat modes already available in this repository -6. **Match Relevance**: Compare available custom chat modes against identified patterns and requirements -7. **Present Options**: Display relevant custom chat modes with descriptions, rationale, and availability status -8. **Validate**: Ensure suggested chatmodes would add value not already covered by existing chatmodes -9. **Output**: Provide structured table with suggestions, descriptions, and links to both awesome-copilot custom chat modes and similar local custom chat modes - **AWAIT** user request to proceed with installation of specific custom chat modes. DO NOT INSTALL UNLESS DIRECTED TO DO SO. -10. **Download Assets**: For requested chat modes, automatically download and install individual chat modes to `.github/agents/` folder. Do NOT adjust content of the files. Use `#todos` tool to track progress. Prioritize use of `#fetch` tool to download assets, but may use `curl` using `#runInTerminal` tool to ensure all content is retrieved. - -## Context Analysis Criteria - -🔍 **Repository Patterns**: -- Programming languages used (.cs, .js, .py, etc.) -- Framework indicators (ASP.NET, React, Azure, etc.) -- Project types (web apps, APIs, libraries, tools) -- Documentation needs (README, specs, ADRs) - -🗨️ **Chat History Context**: -- Recent discussions and pain points -- Feature requests or implementation needs -- Code review patterns -- Development workflow requirements - -## Output Format - -Display analysis results in structured table comparing awesome-copilot custom chat modes with existing repository custom chat modes: - -| Awesome-Copilot Custom Chat Mode | Description | Already Installed | Similar Local Custom Chat Mode | Suggestion Rationale | -|---------------------------|-------------|-------------------|-------------------------|---------------------| -| [code-reviewer.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/code-reviewer.agent.md) | Specialized code review custom chat mode | ❌ No | None | Would enhance development workflow with dedicated code review assistance | -| [architect.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/architect.agent.md) | Software architecture guidance | ✅ Yes | azure_principal_architect.agent.md | Already covered by existing architecture custom chat modes | -| [debugging-expert.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/debugging-expert.agent.md) | Debug assistance custom chat mode | ❌ No | None | Could improve troubleshooting efficiency for development team | - -## Local Chatmodes Discovery Process - -1. List all `*.agent.md` files in `.github/agents/` directory -2. For each discovered file, read front matter to extract `description` -3. Build comprehensive inventory of existing chatmodes -4. Use this inventory to avoid suggesting duplicates - -## Requirements - -- Use `githubRepo` tool to get content from awesome-copilot repository chatmodes folder -- Scan local file system for existing chatmodes in `.github/agents/` directory -- Read YAML front matter from local chatmode files to extract descriptions -- Compare against existing chatmodes in this repository to avoid duplicates -- Focus on gaps in current chatmode library coverage -- Validate that suggested chatmodes align with repository's purpose and standards -- Provide clear rationale for each suggestion -- Include links to both awesome-copilot chatmodes and similar local chatmodes -- Don't provide any additional information or context beyond the table and the analysis - -## Icons Reference - -- ✅ Already installed in repo -- ❌ Not installed in repo