create-agent-skills

Structure Claude Skills by creating a SKILL.md file with YAML frontmatter for metadata validation and a pure XML body for content. Organize directories using verb-noun conventions and move detailed guidance into reference files for progressive disclosure.

Progressive disclosure in skill authoring keeps SKILL.md concise by moving detailed guidance into separate reference files. This pattern ensures the main skill file remains readable while still providing in-depth coverage of XML structure, security, testing, and workflows.

Validate YAML frontmatter by enforcing consistent naming and discovery conventions defined in the skill authoring framework. This validation guarantees metadata consistency across skills, ensuring they are discoverable and safely extensible within the ecosystem.

Yes, you can reuse and template Claude Skills across multiple teams. The standardized directory organization, frontmatter conventions, and XML-first structure enable scalable automation and easy replication of skills for different use cases.

Organize reference files by placing them in a dedicated references/ directory within the skill folder. This approach supports progressive disclosure by separating in-depth guidance on XML structure, security, and workflows from the concise SKILL.md file.

A pure XML body in SKILL.md enforces a standardized, XML-first structure that ensures safety, consistency, and discoverability. This format prevents parsing ambiguity and aligns with the Claude Code Conductor ecosystem's best practices for skill authoring.