agent-creator

Define a subagent by writing a markdown file with required frontmatter fields: description and capabilities for plugin agents, or name and description for user agents. Place plugin agents at plugins/<category>/<plugin>/agents/agent-name.md and include a capabilities list matching your agent's specialized functions.

Plugin agents require description and capabilities fields in frontmatter and live under plugins/<category>/<plugin>/agents/. User/project agents require only name and description, with optional tools and model settings. Plugin agents standardize agents for distribution; user agents support personal workflows.

Plugin agents require description and capabilities. User agents require name and description. Both support optional fields. Include agent title, capabilities list describing specialized functions, 'When to Use' guidance, and 'Context and Examples' sections to clarify invocation criteria.

Yes. Specify capabilities as a list in frontmatter reflecting your agent's specialized functions. Capabilities describe what the agent can perform—code review, security analysis, documentation generation—and guide when Claude Code should invoke that specific agent.

Include a 'Context and Examples' section showing realistic invocation scenarios. Provide example inputs and outputs demonstrating when and how the agent activates, matching your capabilities list and 'When to Use' guidance for clarity.

Yes. Agent definitions use YAML frontmatter to declare metadata: name, description, title, capabilities, and optional tools and model. This frontmatter standardizes how Claude Code recognizes and routes to specialized agents.