agent-conventions

What problem does it solve?

Inconsistent agent definitions, unclear delegation patterns, and missing structural conventions make agents fragile and hard to discover or maintain; this Skill provides a single source of truth for how to define, name, and structure agents and subagents for GitHub Copilot Chat in VS Code.

Core Features & Use Cases

• Provides a user-facing agent template and a subagent template with required frontmatter fields and recommended tools to ensure consistent discovery and behavior.
• Defines architecture guidance for lean orchestrators and specialized subagents, including delegation patterns, handoffs, and the three-layer test for uniqueness.
• Documents file naming conventions (PascalCase .agent.md), required frontmatter keys (name, description, tools, agents, user-invokable), and guidance on constraints, skills references, and tool lists for reliable orchestration.

Quick Start

Ask the assistant to generate a new PascalCase .agent.md file using the provided user-facing agent template and include explicit tools, constraints, and skills references.