Suggest awesome GitHub Copilot skills
Analyze repository context and the GitHub awesome-copilot skill catalog, then recommend missing or outdated self-contained Agent Skills without installing or updating anything unless the user explicitly asks.
When to invoke
- "Suggest awesome-copilot skills for this repo."
- "Which GitHub Copilot skills should we install?"
- "Compare our skills with awesome-copilot."
- "Find outdated local skills from awesome-copilot."
- "Recommend Agent Skills for this project."
Prerequisites and context
- Remote catalog: https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md.
- Remote skill folders live under https://github.com/github/awesome-copilot/tree/main/skills.
- Use
web_fetch for README and raw SKILL.md files. Use execute/bash with curl only when a bundled asset cannot be retrieved completely through web_fetch.
- Scan local skills from
.github/skills/ first; if that folder does not exist, report that no local project skills were found.
- Do not install, update, replace, or delete skills until the user asks for a specific install or update.
- Legacy references to
#fetch, #runInTerminal, #todos, fetch, and githubRepo mean the current CLI equivalents are web_fetch, execute/bash, session tracking, and raw GitHub URLs.
Procedure
- Fetch the available skill list and descriptions from https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md.
- List all folders in
.github/skills/.
- For each local folder, read
SKILL.md front matter and extract name and description.
- List bundled assets in each local skill folder.
- For each local skill that appears in awesome-copilot, fetch the remote raw file at
https://raw.githubusercontent.com/github/awesome-copilot/main/skills/{skill-name}/SKILL.md.
- Compare entire local and remote
SKILL.md content, including front matter and body.
- Identify exact matches, outdated skills, front matter changes, instruction changes, and bundled asset changes.
- Review chat history, repository files, languages, frameworks, cloud providers, infrastructure, testing, CI/CD, deployment, and specialized workflow needs.
- Compare available remote skills with local skills to avoid duplicates and find coverage gaps.
- Present a structured table with suggestions, descriptions, bundled assets, install status, similar local skills, rationale, and links.
- AWAIT user request before installation or update: DO NOT INSTALL OR UPDATE UNLESS DIRECTED to proceed.
- Download/Update assets only after direction: download the full remote skill folder into
.github/skills/, preserve folder structure, include SKILL.md and bundled assets, and do not adjust content.
Context analysis criteria
| Area |
Inspect for |
| Repository patterns |
Programming languages such as .cs, .js, .py, .ts; frameworks such as ASP.NET, React, Azure, and Next.js; project types such as web apps, APIs, libraries, tools, and infrastructure. |
| Development workflow |
Testing, CI/CD, deployment, package managers, and validation commands. |
| Infrastructure and cloud |
Azure, AWS, GCP, Terraform, Bicep, Kubernetes, and workflow automation. |
| Chat history context |
Recent discussions, pain points, feature requests, code review patterns, and specialized task needs. |
| Local skills |
Existing capabilities, duplicate coverage, similar names, descriptions, and bundled assets. |
Version comparison rules
| Status |
Definition |
| Already installed and up-to-date |
Local SKILL.md exactly matches the remote awesome-copilot SKILL.md. |
| Installed but outdated |
Local skill exists and remote content differs. |
| Not installed in repo |
Remote skill is relevant and no matching local skill exists. |
For outdated skills, document front matter changes, instruction updates, and bundled asset changes. Calculate similarity qualitatively enough to explain whether an update is recommended.
Example remote raw URL pattern:
https://raw.githubusercontent.com/github/awesome-copilot/main/skills/{skill-name}/SKILL.md
Example skill links to preserve in output:
Skill structure checks
Each Agent Skill is a folder containing SKILL.md with YAML front matter and optional bundled assets. Folder names are lowercase with hyphens, for example azure-deployment-preflight. The name field must match the folder name. awesome-copilot front matter commonly uses:
---
name: 'skill-name'
description: 'Brief description of what this skill provides and when to use it'
---
Limits
- Do not provide commentary beyond the table and analysis requested.
- Do not install or update unless directed.
- Do not adjust remote skill contents during install or update.
- Do not suggest duplicates already covered by equal or stronger local skills.
- Do not rely on relative links between primitives; use remote GitHub URLs for awesome-copilot links.
Output template
## Awesome Copilot skill suggestions
| Awesome-Copilot Skill | Description | Bundled Assets | Already Installed | Similar Local Skill | Suggestion Rationale |
| --- | --- | --- | --- | --- | --- |
| [gh-attach](https://github.com/github/awesome-copilot/tree/main/skills/gh-attach) | GitHub CLI skill for managing repositories and workflows | None | No | None | Would enhance GitHub workflow automation capabilities |
| [aspire](https://github.com/github/awesome-copilot/tree/main/skills/aspire) | Aspire skill for distributed application development | 9 reference files | Yes | aspire | Already covered by existing Aspire skill |
| [terraform-azurerm-set-diff-analyzer](https://github.com/github/awesome-copilot/tree/main/skills/terraform-azurerm-set-diff-analyzer) | Analyze Terraform AzureRM provider changes | Reference files | Outdated | terraform-azurerm-set-diff-analyzer | Instructions updated with new validation patterns; update recommended |
### Analysis
- Local skills scanned: <count or folder missing>
- Remote skills considered: <count>
- Recommended installs: <count>
- Recommended updates: <count>
Quality gate
References
1---2name: suggest-awesome-github-copilot-skills-23description: Suggest relevant GitHub Copilot Agent Skills from the awesome-copilot repository by comparing remote skills with local repository skills, detecting missing or outdated skills, bundled assets, duplicates, and repository-fit gaps. Use when the user asks which awesome-copilot skills to install, update, compare, or recommend for the current repository.4---56# Suggest awesome GitHub Copilot skills78Analyze repository context and the GitHub awesome-copilot skill catalog, then recommend missing or outdated self-contained Agent Skills without installing or updating anything unless the user explicitly asks.910## When to invoke1112- "Suggest awesome-copilot skills for this repo."13- "Which GitHub Copilot skills should we install?"14- "Compare our skills with awesome-copilot."15- "Find outdated local skills from awesome-copilot."16- "Recommend Agent Skills for this project."1718## Prerequisites and context1920- Remote catalog: https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md.21- Remote skill folders live under https://github.com/github/awesome-copilot/tree/main/skills.22- Use `web_fetch` for README and raw `SKILL.md` files. Use `execute/bash` with `curl` only when a bundled asset cannot be retrieved completely through `web_fetch`.23- Scan local skills from `.github/skills/` first; if that folder does not exist, report that no local project skills were found.24- Do not install, update, replace, or delete skills until the user asks for a specific install or update.25- Legacy references to `#fetch`, `#runInTerminal`, `#todos`, `fetch`, and `githubRepo` mean the current CLI equivalents are `web_fetch`, `execute/bash`, session tracking, and raw GitHub URLs.2627## Procedure28291. Fetch the available skill list and descriptions from https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md.302. List all folders in `.github/skills/`.313. For each local folder, read `SKILL.md` front matter and extract `name` and `description`.324. List bundled assets in each local skill folder.335. For each local skill that appears in awesome-copilot, fetch the remote raw file at `https://raw.githubusercontent.com/github/awesome-copilot/main/skills/{skill-name}/SKILL.md`.346. Compare entire local and remote `SKILL.md` content, including front matter and body.357. Identify exact matches, outdated skills, front matter changes, instruction changes, and bundled asset changes.368. Review chat history, repository files, languages, frameworks, cloud providers, infrastructure, testing, CI/CD, deployment, and specialized workflow needs.379. Compare available remote skills with local skills to avoid duplicates and find coverage gaps.3810. Present a structured table with suggestions, descriptions, bundled assets, install status, similar local skills, rationale, and links.3911. AWAIT user request before installation or update: DO NOT INSTALL OR UPDATE UNLESS DIRECTED to proceed.4012. Download/Update assets only after direction: download the full remote skill folder into `.github/skills/`, preserve folder structure, include `SKILL.md` and bundled assets, and do not adjust content.4142## Context analysis criteria4344| Area | Inspect for |45| --- | --- |46| Repository patterns | Programming languages such as `.cs`, `.js`, `.py`, `.ts`; frameworks such as ASP.NET, React, Azure, and Next.js; project types such as web apps, APIs, libraries, tools, and infrastructure. |47| Development workflow | Testing, CI/CD, deployment, package managers, and validation commands. |48| Infrastructure and cloud | Azure, AWS, GCP, Terraform, Bicep, Kubernetes, and workflow automation. |49| Chat history context | Recent discussions, pain points, feature requests, code review patterns, and specialized task needs. |50| Local skills | Existing capabilities, duplicate coverage, similar names, descriptions, and bundled assets. |5152## Version comparison rules5354| Status | Definition |55| --- | --- |56| Already installed and up-to-date | Local `SKILL.md` exactly matches the remote awesome-copilot `SKILL.md`. |57| Installed but outdated | Local skill exists and remote content differs. |58| Not installed in repo | Remote skill is relevant and no matching local skill exists. |5960For outdated skills, document front matter changes, instruction updates, and bundled asset changes. Calculate similarity qualitatively enough to explain whether an update is recommended.6162Example remote raw URL pattern:6364```text65https://raw.githubusercontent.com/github/awesome-copilot/main/skills/{skill-name}/SKILL.md66```6768Example skill links to preserve in output:6970- https://github.com/github/awesome-copilot/tree/main/skills/gh-attach71- https://github.com/github/awesome-copilot/tree/main/skills/aspire72- https://github.com/github/awesome-copilot/tree/main/skills/terraform-azurerm-set-diff-analyzer7374## Skill structure checks7576Each Agent Skill is a folder containing `SKILL.md` with YAML front matter and optional bundled assets. Folder names are lowercase with hyphens, for example `azure-deployment-preflight`. The `name` field must match the folder name. awesome-copilot front matter commonly uses:7778```markdown79---80name: 'skill-name'81description: 'Brief description of what this skill provides and when to use it'82---83```8485## Limits8687- Do not provide commentary beyond the table and analysis requested.88- Do not install or update unless directed.89- Do not adjust remote skill contents during install or update.90- Do not suggest duplicates already covered by equal or stronger local skills.91- Do not rely on relative links between primitives; use remote GitHub URLs for awesome-copilot links.9293## Output template9495```markdown96## Awesome Copilot skill suggestions9798| Awesome-Copilot Skill | Description | Bundled Assets | Already Installed | Similar Local Skill | Suggestion Rationale |99| --- | --- | --- | --- | --- | --- |100| [gh-attach](https://github.com/github/awesome-copilot/tree/main/skills/gh-attach) | GitHub CLI skill for managing repositories and workflows | None | No | None | Would enhance GitHub workflow automation capabilities |101| [aspire](https://github.com/github/awesome-copilot/tree/main/skills/aspire) | Aspire skill for distributed application development | 9 reference files | Yes | aspire | Already covered by existing Aspire skill |102| [terraform-azurerm-set-diff-analyzer](https://github.com/github/awesome-copilot/tree/main/skills/terraform-azurerm-set-diff-analyzer) | Analyze Terraform AzureRM provider changes | Reference files | Outdated | terraform-azurerm-set-diff-analyzer | Instructions updated with new validation patterns; update recommended |103104### Analysis105- Local skills scanned: <count or folder missing>106- Remote skills considered: <count>107- Recommended installs: <count>108- Recommended updates: <count>109```110111## Quality gate112113- [ ] The awesome-copilot README skills catalog was fetched from https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md.114- [ ] Local `.github/skills/` folders and front matter were scanned or reported absent.115- [ ] Remote raw `SKILL.md` files were fetched for local skills that appear in the catalog.116- [ ] Each recommendation explains relevance to repository context and avoids duplicates.117- [ ] Outdated skills include specific differences or update rationale.118- [ ] No install, update, delete, or content adjustment occurred without a user request.119- [ ] The output uses the table format exactly and includes remote skill links.120121## References122123- [awesome-copilot skills README](https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md)124- [awesome-copilot skills folder](https://github.com/github/awesome-copilot/tree/main/skills)125- [gh-attach skill](https://github.com/github/awesome-copilot/tree/main/skills/gh-attach)126- [aspire skill](https://github.com/github/awesome-copilot/tree/main/skills/aspire)127- [terraform-azurerm-set-diff-analyzer skill](https://github.com/github/awesome-copilot/tree/main/skills/terraform-azurerm-set-diff-analyzer)