Validate agent definition files for correct YAML frontmatter syntax. Use when creating, editing, or reviewing agent .md files to catch common errors before they cause runtime failures.
Validate all agent definition files in .github/agents/ (and .claude/agents/ if not symlinked).
Find all agent files:
Glob: .github/agents/**/*.md
Glob: .claude/agents/**/*.md
For each agent file, read it and validate the YAML frontmatter against these rules:
name — must be present, lowercase with hyphens onlydescription — must be present, non-empty stringtools — if present, must be a YAML array (each item on its own - item line)disallowedTools — if present, must be a YAML arrayskills — if present, must be a YAML arrayCommon wrong pattern to detect: