Suggest Awesome Github Copilot Agents
Discover Copilot custom agents you are missing from awesome-copilot and flag local copies that are stale versus upstream.
Overview
suggest-awesome-github-copilot-agents is an agent skill for the Build phase that recommends awesome-copilot Custom Agents files and detects duplicates or outdated local copies.
Install
npx skills add https://github.com/github/awesome-copilot --skill suggest-awesome-github-copilot-agentsWhat is this skill?
- 5-step process: fetch awesome-copilot agent index, scan local `.github/agents/`, compare descriptions
- Uses fetch on README.agents.md and raw GitHub URLs for remote agent bodies
- Skips agents already present locally and surfaces outdated local variants
- Maps chat and repo context to relevant upstream custom agents
- 5-step comparison process including remote fetch per local agent
Adoption & trust: 8.5k installs on skills.sh; 34.6k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You run Copilot custom agents in your repo but do not know which upstream awesome-copilot agents you are missing or whether your copies are out of date.
Who is it for?
Repos already using `.github/agents/` who want curated suggestions without manually browsing awesome-copilot.
Skip if: Teams not using GitHub Copilot Custom Agents, or builders who only need Claude Code skills with no Copilot agent folder.
When should I use this skill?
You want relevant Custom Agents from awesome-copilot based on repo context and chat, avoiding duplicates and spotting outdated local agents.
What do I get? / Deliverables
You receive a contextual shortlist of agents to add plus clarity on which local agent files need refreshing from github/awesome-copilot.
- Suggested agent filenames to adopt
- Duplicate and outdated-agent report
- Links or paths to upstream agent sources
Recommended Skills
Journey fit
Build is where you assemble agent definitions under `.github/agents/` and want a curated catalog match—not launch or growth work. Agent-tooling subphase covers selecting, syncing, and deduplicating custom agent files for GitHub Copilot workflows.
How it compares
Catalog sync for Copilot agent markdown files—not a marketplace MCP server or a generic skills.sh installer.
Common Questions / FAQ
Who is suggest-awesome-github-copilot-agents for?
Solo builders and small teams standardizing GitHub Copilot Custom Agents who want upstream suggestions aligned with their repo and chat context.
When should I use suggest-awesome-github-copilot-agents?
During Build while setting up or expanding agent-tooling, before a major Copilot workflow push, or when onboarding a new repo that should inherit community agents.
Is suggest-awesome-github-copilot-agents safe to install?
The workflow fetches public GitHub content and reads local agent files; confirm trust in awesome-copilot sources and review the Security Audits panel on this page before auto-copying files.
SKILL.md
READMESKILL.md - Suggest Awesome Github Copilot Agents
# Suggest Awesome GitHub Copilot Custom Agents Analyze current repository context and suggest relevant Custom Agents files from the [GitHub awesome-copilot repository](https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md) that are not already available in this repository. Custom Agent files are located in the [agents](https://github.com/github/awesome-copilot/tree/main/agents) folder of the awesome-copilot repository. ## Process 1. **Fetch Available Custom Agents**: Extract Custom Agents list and descriptions from [awesome-copilot README.agents.md](https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md). Must use `fetch` tool. 2. **Scan Local Custom Agents**: Discover existing custom agent files in `.github/agents/` folder 3. **Extract Descriptions**: Read front matter from local custom agent files to get descriptions 4. **Fetch Remote Versions**: For each local agent, fetch the corresponding version from awesome-copilot repository using raw GitHub URLs (e.g., `https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>`) 5. **Compare Versions**: Compare local agent content with remote versions to identify: - Agents that are up-to-date (exact match) - Agents that are outdated (content differs) - Key differences in outdated agents (tools, description, content) 6. **Analyze Context**: Review chat history, repository files, and current project needs 7. **Match Relevance**: Compare available custom agents against identified patterns and requirements 8. **Present Options**: Display relevant custom agents with descriptions, rationale, and availability status including outdated agents 9. **Validate**: Ensure suggested agents would add value not already covered by existing agents 10. **Output**: Provide structured table with suggestions, descriptions, and links to both awesome-copilot custom agents and similar local custom agents **AWAIT** user request to proceed with installation or updates of specific custom agents. DO NOT INSTALL OR UPDATE UNLESS DIRECTED TO DO SO. 11. **Download/Update Assets**: For requested agents, automatically: - Download new agents to `.github/agents/` folder - Update outdated agents by replacing with latest version from awesome-copilot - Do NOT adjust content of the files - Use `#fetch` tool to download assets, but may use `curl` using `#runInTerminal` tool to ensure all content is retrieved - Use `#todos` tool to track progress ## 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 agents with existing repository custom agents: | Awesome-Copilot Custom Agent | Description | Already Installed | Similar Local Custom Agent | Suggestion Rationale | | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----