skill-creator

Create, validate, and package Claude skill directories with scripts and references.

Updated Feb 22, 2026

Search Tags:#validation #scaffolding #skill creation #claude #packaging #progressive disclosure #frontmatter

Ready to run

npx skills add https://github.com/mashharuki/CareTech-Catalyst-Hackathon --skill skill-creator-mashharuki

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/mashharuki/CareTech-Catalyst-Hackathon/tree/main/.trae/skills/skill-creator
Command: npx skills add https://github.com/mashharuki/CareTech-Catalyst-Hackathon --skill skill-creator-mashharuki

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Designing a well-structured skill for Claude requires knowing frontmatter rules, progressive disclosure patterns, and packaging conventions, which is easy to get wrong without guidance. ## Core Features & Use Cases - Skill Scaffolding: Run init_skill.py to generate a complete skill directory with SKILL.md template and example scripts, references, and assets folders. - Design Guidance: Apply core principles like concise context usage, degrees of freedom, and progressive disclosure when writing SKILL.md instructions. - Validation & Packaging: Use package_skill.py to validate frontmatter, naming conventions, and structure, then bundle the skill into a distributable .skill file. - Use Case: When you want to build a new skill for PDF processing, use this skill to scaffold the directory, write effective instructions following workflow and output patterns, and package it for distribution. ## Quick Start Create a new skill named pdf-rotator in the current directory and walk me through writing its SKILL.md.

Frequently Asked Questions about skill-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create a new Claude skill from scratch?▼

Run scripts/init_skill.py with a kebab-case skill name and output path to generate a template directory containing SKILL.md plus example scripts, references, and assets folders. Then edit SKILL.md and customize the resources.

What should go in the SKILL.md frontmatter?▼

The frontmatter requires a name and description field. The description is the primary triggering mechanism, so include both what the skill does and specific scenarios when it should be used.

How do I package a skill into a .skill file?▼

Run scripts/package_skill.py with the path to your skill folder. It validates the skill first, checking frontmatter, naming conventions, and structure, then creates a zip-based .skill file if validation passes.

When should I use scripts versus references in a skill?▼

Use scripts for deterministic, repeatedly rewritten code that can execute without loading into context. Use references for documentation Claude should read on demand, like schemas, API docs, or detailed workflow guides.

Why does skill validation fail during packaging?▼

Validation fails when frontmatter is missing required fields, the name is not kebab-case, the description exceeds 1024 characters or contains angle brackets, or unexpected frontmatter keys are present.