skill-creator

Creating a Claude Skill requires generating SKILL.md with valid YAML frontmatter (name and description fields mandatory), then organizing optional resources into scripts/, references/, and assets/ directories. Use the included init_skill.py template to scaffold a new skill, customize the frontmatter and instructional body to match your domain, and validate with package_skill.py before distribution.

SKILL.md contains YAML frontmatter defining metadata (name, description, keywords) followed by instructional content structured as Workflow-Based, Task-Based, Reference, or Capabilities-Based patterns. This structure ensures consistency across deployments, enables progressive disclosure of resources, and satisfies both functional requirements and packaging standards for reusable domain extensions.

Yes. The package_skill.py utility validates SKILL.md frontmatter completeness, YAML syntax, structural pattern compliance, and resource layout (scripts/, references/, assets/). Running this validation before distribution confirms your Skill meets mandatory fields, prescribed patterns, and technical requirements for deployment.

Skill structures prescribe how instructional content is organized: Workflow-Based sequences multi-step processes, Task-Based isolates discrete operations, Reference provides lookup information, and Capabilities-Based enumerates Claude extensions. Choosing the right structure ensures your Skill's domain knowledge, workflows, or tool integrations are presented clearly and consistently.

Scripts, references, and assets are optional resource bundles. Include them only if your Skill requires supporting code, external documentation, or media files. The three-resource layout accommodates Skills ranging from simple reference documents to complex tool integrations with validation and packaging utilities.

The Skill creation process follows init, edit, package, iterate cycles. Edit SKILL.md frontmatter and instructional body, re-run package_skill.py to validate changes against standards, and repeat until your Skill meets distribution requirements. This workflow ensures updates maintain consistency and technical compliance.