|
| 1 | +--- |
| 2 | +agent: "agent" |
| 3 | +description: "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." |
| 4 | +tools: ["edit", "search", "runCommands", "runTasks", "changes", "testFailure", "openSimpleBrowser", "fetch", "githubRepo", "todos"] |
| 5 | +--- |
| 6 | + |
| 7 | +# Suggest Awesome GitHub Copilot Custom Agents |
| 8 | + |
| 9 | +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. |
| 10 | + |
| 11 | +## Process |
| 12 | + |
| 13 | +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. |
| 14 | +2. **Scan Local Custom Agents**: Discover existing custom agent files in `.github/agents/` folder |
| 15 | +3. **Extract Descriptions**: Read front matter from local custom agent files to get descriptions |
| 16 | +4. **Analyze Context**: Review chat history, repository files, and current project needs |
| 17 | +5. **Compare Existing**: Check against custom agents already available in this repository |
| 18 | +6. **Match Relevance**: Compare available custom agents against identified patterns and requirements |
| 19 | +7. **Present Options**: Display relevant custom agents with descriptions, rationale, and availability status |
| 20 | +8. **Validate**: Ensure suggested agents would add value not already covered by existing agents |
| 21 | +9. **Output**: Provide structured table with suggestions, descriptions, and links to both awesome-copilot custom agents and similar local custom agents |
| 22 | + **AWAIT** user request to proceed with installation of specific custom agents. DO NOT INSTALL UNLESS DIRECTED TO DO SO. |
| 23 | +10. **Download Assets**: For requested agents, automatically download and install individual agents 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. |
| 24 | + |
| 25 | +## Context Analysis Criteria |
| 26 | + |
| 27 | +🔍 **Repository Patterns**: |
| 28 | + |
| 29 | +- Programming languages used (.cs, .js, .py, etc.) |
| 30 | +- Framework indicators (ASP.NET, React, Azure, etc.) |
| 31 | +- Project types (web apps, APIs, libraries, tools) |
| 32 | +- Documentation needs (README, specs, ADRs) |
| 33 | + |
| 34 | +🗨️ **Chat History Context**: |
| 35 | + |
| 36 | +- Recent discussions and pain points |
| 37 | +- Feature requests or implementation needs |
| 38 | +- Code review patterns |
| 39 | +- Development workflow requirements |
| 40 | + |
| 41 | +## Output Format |
| 42 | + |
| 43 | +Display analysis results in structured table comparing awesome-copilot custom agents with existing repository custom agents: |
| 44 | + |
| 45 | +| Awesome-Copilot Custom Agent | Description | Already Installed | Similar Local Custom Agent | Suggestion Rationale | |
| 46 | +| ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------------------------- | ------------------------------------------------------------- | |
| 47 | +| [amplitude-experiment-implementation.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/amplitude-experiment-implementation.agent.md) | This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features | ❌ No | None | Would enhance experimentation capabilities within the product | |
| 48 | +| [launchdarkly-flag-cleanup.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/launchdarkly-flag-cleanup.agent.md) | Feature flag cleanup agent for LaunchDarkly | ✅ Yes | launchdarkly-flag-cleanup.agent.md | Already covered by existing LaunchDarkly custom agents | |
| 49 | + |
| 50 | +## Local Agent Discovery Process |
| 51 | + |
| 52 | +1. List all `*.agent.md` files in `.github/agents/` directory |
| 53 | +2. For each discovered file, read front matter to extract `description` |
| 54 | +3. Build comprehensive inventory of existing agents |
| 55 | +4. Use this inventory to avoid suggesting duplicates |
| 56 | + |
| 57 | +## Requirements |
| 58 | + |
| 59 | +- Use `githubRepo` tool to get content from awesome-copilot repository agents folder |
| 60 | +- Scan local file system for existing agents in `.github/agents/` directory |
| 61 | +- Read YAML front matter from local agent files to extract descriptions |
| 62 | +- Compare against existing agents in this repository to avoid duplicates |
| 63 | +- Focus on gaps in current agent library coverage |
| 64 | +- Validate that suggested agents align with repository's purpose and standards |
| 65 | +- Provide clear rationale for each suggestion |
| 66 | +- Include links to both awesome-copilot agents and similar local agents |
| 67 | +- Don't provide any additional information or context beyond the table and the analysis |
| 68 | + |
| 69 | +## Icons Reference |
| 70 | + |
| 71 | +- ✅ Already installed in repo |
| 72 | +- ❌ Not installed in repo |
0 commit comments