creating-subagents

Create a sub-agent by adding a new .md file to your-project/.claude/agents/ with YAML frontmatter (name, description, tools, model, color) and a system prompt. Deploy the file and test activation with a sample request to verify the agent is suggested appropriately.

YAML frontmatter defines sub-agent metadata—name, description, tools, model, and color. It ensures integrity and consistency across project-deployed agents, enabling reliable activation rules and CLAUDE.md integration for automation workflows.

Invoke a sample request matching your agent's intended use case and verify it's suggested or used appropriately. Test prompts help validate activation strategies and improve the agent's reliability and activation rate.

Yes. Modify the existing agent file in .claude/agents/ to update its frontmatter, system prompt, activation rules, and CLAUDE.md integration. Re-test activation to ensure changes align with evolving project standards.

Activation strategies define conditions triggering agent use. Include clear examples and test prompts in your agent definition to refine reliability. Better-defined activation rules increase the likelihood the agent is suggested in relevant contexts.

No templates are required as dependencies. Sub-agents are built from scratch with custom frontmatter and system prompts tailored to your project. Consistent patterns across agents improve onboarding and automation reliability.