skill-creator

Creating a Claude skill starts with initializing a structured template using the provided tooling: run `python3 scripts/init_skill.py <skill-name> --path <path>` to generate the skill directory with required SKILL.md frontmatter and optional resource folders (scripts, references, assets). Customize the frontmatter and add your skill logic, then validate and package it for deployment.

SKILL.md frontmatter must declare metadata like skill name, author, category, keywords, and dependencies. It structures the skill's anatomy and ensures consistent, deployable documentation. Include descriptions of core features, use cases, and quick-start examples to guide users on implementation and packaging.

Organize skills using workflow-based, task-based, reference, or capabilities-based structures depending on your skill type. Store scripts, references, and assets in dedicated resource directories. This ensures repeatable packaging, frontmatter validity, and clarity for teams designing new skills or updating existing ones.

Validate and package your skill by running `python3 scripts/package_skill.py <path-to-skill> [dist]`. This checks frontmatter compliance, verifies resource organization, and generates a distributable package. The process ensures consistent quality and deployability across workflows, tools, and domains.

Yes, the Skill provides multiple template patterns—workflow-based, task-based, reference, and capabilities-based—to suit different skill types and domains. Select the structure that matches your use case, customize it with your domain logic, and follow the guidance to ensure consistent quality and proper packaging.

Invalid frontmatter prevents successful validation and packaging of your skill. The packaging script checks frontmatter compliance and will flag errors. Ensure all required SKILL.md fields are present and properly formatted according to the structured template guidance before distribution.