suggest-awesome-github-copilot-agents Skill (awesome-copilot) for Claude Code: What It Does and How to Install It

Makes Claude suggest awesome-copilot custom agents that fit your repo and flag outdated copies, then install them only when you say so.

Installs: 8.8K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

This skill makes Claude look through your repo and your chat for what you are working on, then suggest custom agents from the awesome-copilot catalog that you do not already have. It reads your .github/agents/ folder, fetches each agent's current version from GitHub and flags the ones that are outdated.

The folder has one file, SKILL.md, and no scripts. It ends with a single table of suggestions and waits for you. SKILL.md says to download or update agents only when you direct it to.

Good for

Teams using GitHub Copilot custom agents who want relevant ones from awesome-copilot
Maintainers checking if their .github/agents/ files are outdated
Anyone starting a repo and unsure which agents exist

Install suggest-awesome-github-copilot-agents

Claude Code

1
Download the skill folder from https://github.com/github/awesome-copilot/tree/HEAD/skills/suggest-awesome-github-copilot-agents.
2
Put it at ~/.claude/skills/suggest-awesome-github-copilot-agents/ so that SKILL.md sits directly inside.
3
Start a new session; the skill loads when its description matches the task.

Pick one route. The Copilot CLI plugin route installs the awesome-copilot plugin from the awesome-copilot marketplace: 3 skills (suggest-awesome-github-copilot-agents, -instructions and -skills), the meta-agentic-project-scaffold agent, and an mcp.json that starts a Docker-based awesome-copilot MCP server. The other routes install only suggest-awesome-github-copilot-agents. The repo README says its customizations come from third-party developers, so inspect them before installing.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

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.

Sections in SKILL.md

Process
Context Analysis Criteria
Output Format
Local Agent Discovery Process
Version Comparison Process
Requirements
Icons Reference
Update Handling

Key facts

Author: Awesome Copilot Community (author named in the awesome-copilot plugin.json, not in the skill file); the repo LICENSE reads "Copyright GitHub, Inc."
License: MIT (repo LICENSE)
Installs on skills.sh: 8,779 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 1 file: SKILL.md (no scripts)
Needs: A fetch tool for GitHub URLs; a .github/agents/ folder to compare against
Part of: awesome-copilot plugin (3 skills, 1 agent and an MCP config, counted from its plugin.json and mcp.json)

What it includes

Reads the agent list from awesome-copilot's docs/README.agents.md
SKILL.md says this must use the fetch tool.
Try: “Suggest awesome-copilot agents that fit this repo”
Network · Fetch the catalog
Lists *.agent.md files in .github/agents/ and reads their descriptions
Used to avoid suggesting agents you already have.
Files · Scan local agents
Fetches each local agent's remote copy and flags differences
Marks each as up to date, outdated or not installed, and notes differences in tools, description or content.
Network · Compare versions
One table: agent, description, installed status, similar local agent, rationale
SKILL.md says to give nothing beyond the table and the analysis.
Read · Suggestion table
Saves new agents to .github/agents/ and replaces outdated ones
SKILL.md says not to install or update unless you direct it to, not to change the file content, and that it may use curl in the terminal.
Write · Download or update on request

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It downloads agent files into your repo
When you ask it to install or update, it saves files to .github/agents/, replaces outdated local copies and may use curl in the terminal. Agent files steer an AI assistant. Our advice: read each one first. The awesome-copilot README says its content is sourced from third-party developers. github.com
The plugin route adds an MCP server config and an agent
The awesome-copilot plugin has an mcp.json that runs docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:latest as a stdio server. It also adds the meta-agentic-project-scaffold agent, whose file lists tools including runCommands, fetch and edit/editFiles. Use a folder route to install only this skill. github.com

Technical details

Turning on read-only	No read-only mode.
Talks to	GitHub (github.com and raw.githubusercontent.com, for the catalog and agent files)
Sign-in and keys	No credentials are named in SKILL.md.
Scopes	Reads your .github/agents/ folder Fetches the awesome-copilot catalog and agent files from GitHub Writes or replaces agent files in .github/agents/ when you ask

Questions

What does the suggest-awesome-github-copilot-agents skill do?

It makes Claude compare the custom agents in your repo's .github/agents/ folder with the awesome-copilot catalog. It then suggests ones that fit your project and points out outdated copies.

Will it install agents without asking?

SKILL.md says not to install or update unless you direct it to. When you do, it downloads new agents to .github/agents/ and replaces outdated ones with the latest version without changing the content.

Does it work in Claude Code?

It is written for GitHub Copilot custom agents. SKILL.md refers to Copilot tools such as githubRepo and fetch and to the .github/agents/ folder. Our advice: check that your client can fetch URLs before relying on it.

Are there companion skills?

Yes, in the same plugin: suggest-awesome-github-copilot-instructions and suggest-awesome-github-copilot-skills. This page covers the agents one.

How do I install it?

Use the install box at the top of this page. The repo README documents Copilot CLI plugins from the awesome-copilot marketplace, and the awesome-copilot plugin includes this skill. The box also has folder routes that install only this skill.

What else does the plugin add?

Its plugin.json lists 3 skills and the meta-agentic-project-scaffold agent. The plugin also has an mcp.json that starts an awesome-copilot MCP server with Docker.

Is it safe?

It fetches files from GitHub and, when you ask, writes them into .github/agents/ in your repo. The README says awesome-copilot content comes from third-party developers. Our advice: read an agent file before you add it. The plugin route also adds an MCP server config and an agent.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/suggest-awesome-github-copilot-agents

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

suggest-awesome-github-copilot-agents SKILL.md · github.com
awesome-copilot README · github.com
awesome-copilot plugin.json · github.com
awesome-copilot plugin mcp.json · github.com
awesome-copilot LICENSE · github.com