kata-agent-author

To create a Claude Code subagent markdown file, use a validated scaffolding process that generates YAML frontmatter with a required name and concrete description, ensuring downstream tooling conformance. The output includes structured sections like Identity, Capabilities, and Restrictions.

Valid Claude Code subagent frontmatter requires a name and a non-placeholder description field. Additionally, the scaffolding guarantees a literal stage: pre-operational line in the markdown body to ensure the agent starts in a safe, pre-operational state.

You can generate a subagent persona from a POV file by optionally composing description and identity blocks from the provided POV source. The scaffolding extracts persona content while keeping the agent definition constrained to the declared description.

Yes, you can overwrite an existing Claude Code subagent markdown file by using force overwrite behavior during destination resolution. The scaffolding process resolves the target path and applies strict slug validation before generating the .claude/agents/<slug>.md file.

Claude Code subagent scaffolds fail conformance checks when frontmatter is missing required fields like name or description, or when placeholder text remains instead of concrete values. Invalid slug formats or absent pre-operational stage lines also break downstream tooling validation.

The best way to scaffold safe and standalone Claude Code subagents is to use deterministic generation that enforces strict slug validation, resolves destination paths, and guarantees required frontmatter plus a literal pre-operational stage line without placeholders.