What problem does it solve? GitHub Copilot custom agents stored as .agent.md files often drift out of sync with the real workspace: they reference stale tool names, invent handoff targets, and grow bloated with inlined standards and mechanical checks. This Skill audits and rewrites those contracts so triggering, routing, handoffs, and prompt size stay correct and lean. ## Core Features & Use Cases - Runtime surface discovery: Scan .github/agents/*.agent.md and skills/*/SKILL.md to enumerate real agents, skills, tools, and handoff pairs before editing any contract. - Contract validation: Check frontmatter fields, kebab-case names, trigger phrasing, and flag declared tools or handoff targets that do not exist in the discovered surface. - Body analysis and minimization: Detect oversized sections, deterministic instructions that belong in scripts, and stale backticked names, then apply a recursive loop that moves standards into references and checks into scripts. - Use Case: Your custom agent keeps telling users to call tools that no longer exist and references a retired handoff target. Run the discovery and validation scripts, correct the routing against the live inventory, and add eval coverage so invented routing fails loudly in the future. ## Quick Start Audit the custom agent at .github/agents/my-agent.agent.md against this repository's real agents and skills, fix stale routing, and trim the prompt body.
