Creating Claude Agents

If you're building Claude Code agents and keep running into validation errors or aren't sure what goes in the frontmatter versus the content, this walks you through the whole structure. It covers the schema requirements (name patterns, field limits, tool permissions), explains when to use sonnet versus opus versus haiku, and shows you how to write the persona definition and process steps. The quick reference alone is worth having open when you're editing agent markdown files. One thing to know: it's pretty strict about the format (lowercase-and-hyphens naming, specific H1 requirements), but that's because the tooling enforces a schema, so better to get it right the first time.