skill-creator

To create a Claude skill, run the initialization script to scaffold the directory, then customize the SKILL.md frontmatter and organize supporting files into scripts, references, and assets folders. Finally, validate and package the skill into a .skill file for distribution.

Progressive disclosure is a design principle that keeps skills self-contained and well-documented by structuring SKILL.md frontmatter and bundled resources to reveal complexity only as needed. It enforces secure, scalable, and reusable skill packaging.

Yes, frontmatter validation is enforced before packaging to ensure the SKILL.md file includes a valid name and description. This standardizes skill documentation and prevents structural errors during the .skill file generation process.

The best way to organize skill resources is to separate them into dedicated directories: scripts for executable code, references for documentation, and assets for static files. This structure supports repeatable tasks and maintains skill scalability.

The packaging workflow processes one skill root directory at a time to generate a .skill file. Each skill must remain self-contained with its own validated SKILL.md and bundled resources to ensure it functions independently.

Skill initialization requires specifying both a skill name and a valid path to the skill root directory. Ensure the target path is writable and does not already contain an existing SKILL.md to avoid scaffolding conflicts.