skill-creator

To structure a SKILL.md file for Claude skills, include required YAML frontmatter metadata fields ensuring discoverability, followed by concise operational instructions. Proper frontmatter and naming constraints guarantee the skill can be reliably loaded, validated, and packaged.

Progressive disclosure in skill authoring means keeping SKILL.md concise with essential workflows while moving large or non-essential content into references/ directories. This approach prevents context bloat and optimizes resource planning for modular knowledge packages.

The best way to package and validate a Claude skill is to follow an end-to-end workflow: understand requirements, plan reusable resources, initialize the structure, then run packaging validation. Ensuring compliance with naming and description constraints makes the resulting skill reliably shippable.

Use scripts/ for executable components and references/ for large or supplementary content when organizing a Claude skill. This separation enforces progressive disclosure, keeping the main SKILL.md lightweight while maintaining access to necessary modular knowledge packages.

Poorly formatted YAML frontmatter prevents a Claude skill from loading correctly because the system relies on this metadata for discoverability and activation. Incomplete metadata, naming violations, or description constraint failures disrupt the validation and packaging readiness process.