create-agent-skills

To create Claude Code skills, you compose a SKILL.md file with standard frontmatter for metadata, then implement XML-based routing to split workflows, references, and scripts for scalable and consistent tooling.

Progressive disclosure in skill authoring keeps SKILL.md concise by loading knowledge on demand. Use it to ensure scalable skills by separating core routing logic from detailed workflow references and scripts.

Structure SKILL.md using standard frontmatter, XML-based structure, and intake routing. Align with Claude Code slash commands by merging command definitions and skill workflows to ensure consistent invocation controls.

This skill authoring guide supports both router and single-file skills. You decide when to split into workflows, references, and scripts based on complexity, ensuring progressive disclosure and reusable patterns.

The best way to manage references when authoring skills is to enforce standard reference management by separating detailed knowledge into dedicated reference files, keeping the main SKILL.md concise and loading context on demand.

Yes, you can refine existing skills by updating workflows and references while enforcing standard frontmatter and invocation controls, ensuring the updated skill structure maintains essential principles and consistency across models.