agent-spec

What problem does it solve?

This skill provides formal knowledge and tooling expectations for designing and validating Claude Code agents and subagents, ensuring consistent frontmatter schemas and correct integration with tools, models, and skills fields.

Core Features & Use Cases

• Documentation and validation of agent file structure according to the official frontmatter requirements.
• Guidance on placing agent data under agents/{agent-name}.md and optionally categorizing with subdirectories.
• Use when creating, updating, or maintaining agents, understanding agent structure, or implementing subagents.

Quick Start

Create an agents/{agent-name}.md file with a frontmatter containing name and description. Optional fields such as tools, model, permissionMode, and skills can be added as needed.