Agent Creator

A skill for creating Claude Code subagents correctly — using the official directory structure, file format, and frontmatter schema that Claude Code actually recognizes.

Critical: Agents Are NOT Skills

Skills live in .claude/skills/ and use SKILL.md files. They provide knowledge and instructions that load into the main conversation context.

Agents (subagents) live in .claude/agents/ and use plain .md files (any filename). They run in their own isolated context window with their own system prompt, tool restrictions, model, and permissions.

NEVER:

• Create a roles/ directory — this is not a Claude Code concept
• Create a ROLE.md file — this format does not exist in Claude Code
• Put agent definitions in .claude/skills/ — agents go in .claude/agents/
• Use AGENT.md as a filename convention — just use {agent-name}.md
• Invent frontmatter fields that Claude Code does not support

When to Create an Agent vs a Skill