agent-creator

Create a new agent file in .claude/agents/ with YAML frontmatter defining metadata, tool permissions, and domain expertise, followed by the agent's prompt content. The frontmatter specifies the agent's name, description, available tools, and configuration rules.

Agent YAML templates require frontmatter fields for agent identity, tool access rules, skill permissions, and domain context, structured in the template.md format. This ensures proper tool validation and capability segmentation across your subagents.

Define domain expertise in the YAML frontmatter by specifying tool permissions, skill access, and contextual constraints for each agent. This segmentation allows specialized subagents to operate only within their intended scope and technical focus areas.

Agent YAML files must pass validation checks for correct frontmatter fields, proper Tools and Skills formatting, and adherence to template.md format rules. Use these validation standards to catch configuration errors early.

No prerequisites are required; start by creating a new .claude/agents/<name>.md file using the agent template. The template provides the full YAML structure needed for frontmatter, tool permissions, and prompt configuration.

Tool-access decision rules in YAML frontmatter define which tools each agent can invoke and under what conditions. These rules enforce permission boundaries and prevent unauthorized tool execution across your agent ecosystem.