skill-creator

Create a Claude Skill by running `scripts/init_skill.py skill-name` to generate a SKILL.md file with required YAML frontmatter (name and description), then organize your code into `scripts/`, `references/`, and `assets/` directories following the workflow, task-based, or reference pattern. The tool validates frontmatter compliance and provides templates for each resource type.

Workflow-based skills guide users through multi-step processes; task-based skills handle specific, discrete actions; reference skills provide guidelines and structured knowledge. Choose based on whether your skill orchestrates steps, performs isolated operations, or primarily documents best practices and specifications for domain expertise.

Use the included validation scripts to check YAML frontmatter compliance, resource structure, and artifact integrity, then run the packaging script to bundle your skill directory. Validation ensures required fields are present and resources follow the correct hierarchy before distribution.

Yes. Place helper functions and integrations in `scripts/`, domain knowledge and schemas in `references/`, and supporting files in `assets/`. This structure enables Progressive Disclosure and keeps specialized knowledge, tool integrations, and utility code modular and discoverable within one Skill.

The SKILL.md frontmatter requires a `name` field and a `description` field. These are enforced during validation. Additional optional fields support categorization, versioning, and dependency declaration, enabling proper indexing and discovery of your Skill.

Define your API schema in `references/`, write integration functions and helper code in `scripts/`, then package the Skill. This approach bundles documentation, executable logic, and examples together, making the internal API accessible to Claude within a self-contained, deployable Skill.