What problem does it solve? VS Code Copilot custom agents fail silently when designs violate runtime constraints: subagents cannot dispatch further subagents, body prose rules are unenforceable, and frontmatter fields like agents: and disable-model-invocation: interact in non-obvious ways. This Skill prevents broken orchestrator designs, silent dispatch no-ops, and frontmatter/body contradictions when authoring *.agent.md files. ## Core Features & Use Cases - Runtime Constraint Reference: Documents seven hard constraints of the VS Code agent runtime, including one-level dispatch depth, frontmatter field semantics, model cost ceilings, and isolated subagent context. - Pitfall-to-Correction Mapping: Provides a table of common design mistakes (orchestrator-dispatches-orchestrator, send: true on gated handoffs) paired with correct forms. - Design Review Checklist & Verification Commands: Ships a pre-ship checklist plus grep-based verification commands to lint agent files for missing allowlists, auto-submitting handoffs, and missing agent tool aliases. - Use Case: When adding a tools: or agents: entry to an agent file, or when a subagent dispatch silently no-ops, consult this Skill to identify which runtime constraint the design violates and how to restructure it. ## Quick Start Review my new orchestrator agent definition against the VS Code runtime constraints and tell me whether its dispatch design will actually work.
