create-skill
Create, update, validate, and canonicalize Claude Code skills. USE WHEN user wants to create a new skill OR modify an existing skill OR validate skill structure OR fix skill format OR migrate legacy skills.
When & Why to Use This Skill
The create-skill tool is a specialized management utility designed to streamline the entire lifecycle of Claude Code skills. It provides a standardized framework for creating, updating, and validating agentic capabilities, ensuring that skills are structurally sound, follow canonical specifications, and are optimized for AI agent execution. By automating boilerplate generation and enforcing validation rules, it significantly enhances developer productivity and skill reliability.
Use Cases
- Skill Initialization: Rapidly bootstrap new Claude skills with a consistent directory structure, including SKILL.md and required workflow templates.
- Quality Assurance: Run automated validation checks to identify structural errors, semantic inconsistencies, or missing documentation in existing skills.
- Legacy Migration: Automatically refactor and canonicalize older skill formats into the latest standard, including file renaming and YAML frontmatter normalization.
- Maintenance and Updates: Efficiently modify existing skill logic and documentation while ensuring the skill remains compliant with the latest schema and best practices.
| name | create-skill |
|---|---|
| description | Create, update, validate, and canonicalize Claude Code skills. USE WHEN user wants to create a new skill OR modify an existing skill OR validate skill structure OR fix skill format OR migrate legacy skills. |
create-skill
Manage Claude Code skills with consistent structure and validation.
Workflow Routing
| Workflow | Trigger | File |
|---|---|---|
| create | User wants to create a new skill | workflows/create.md |
| update | User wants to modify an existing skill | workflows/update.md |
| validate | User wants to verify skill correctness | workflows/validate.md |
| canonicalize | User wants to fix skill structure or migrate legacy format | workflows/canonicalize.md |
Reference Documentation
- skill-schema.md - Canonical skill structure specification
- validation-rules.md - Complete validation checklist
Examples
Example 1: Create a new skill
User: "I want to create a skill for code review"
→ Invokes create workflow
→ Asks for skill name, location, description
→ Generates skill directory with SKILL.md and structure
→ Runs validation
Example 2: Validate an existing skill
User: "Check if my prompting skill is valid"
→ Invokes validate workflow
→ Checks structural, semantic, and quality rules
→ Reports ✅ passed, ⚠️ warnings, ❌ errors
→ Provides specific fix suggestions
Example 3: Fix a broken skill
User: "My skill has wrong file names and missing sections"
→ Invokes canonicalize workflow
→ Renames files to kebab-case
→ Adds missing Examples section
→ Normalizes YAML frontmatter
→ Reports all changes made