Suggest Awesome Github Copilot Agents

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:

Local Agent 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 agents
4. Use this inventory to avoid suggesting duplicates

Version Comparison Process

1. For each local agent file, construct the raw GitHub URL to fetch the remote version:
   • Pattern: https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>
2. Fetch the remote version using the fetch tool
3. Compare entire file content (including front matter, tools array, and body)
4. Identify specific differences:
   • Front matter changes (description, tools)
   • Tools array modifications (added, removed, or renamed tools)
   • Content updates (instructions, examples, guidelines)
5. Document key differences for outdated agents
6. Calculate similarity to determine if update is needed

Requirements

• Use githubRepo tool to get content from awesome-copilot repository agents folder
• Scan local file system for existing agents in .github/agents/ directory
• Read YAML front matter from local agent files to extract descriptions
• Compare local agents with remote versions to detect outdated agents
• Compare against existing agents in this repository to avoid duplicates
• Focus on gaps in current agent library coverage
• Validate that suggested agents align with repository's purpose and standards
• Provide clear rationale for each suggestion
• Include links to both awesome-copilot agents and similar local agents
• Clearly identify outdated agents with specific differences noted
• Don't provide any additional information or context beyond the table and the analysis

Icons Reference

• ✅ Already installed and up-to-date
• ⚠️ Installed but outdated (update available)
• ❌ Not installed in repo

Update Handling

When outdated agents are identified:

1. Include them in the output table with ⚠️ status
2. Document specific differences in the "Suggestion Rationale" column
3. Provide recommendation to update with key changes noted
4. When user requests update, replace entire local file with remote version
5. Preserve file location in .github/agents/ directory