skill-creator

name	skill-creator
description	Create, validate, and package Claude skills - modular packages that extend Claude's capabilities through specialized knowledge, workflows, and tool integrations.
type	domain
enforcement	suggest
priority	high
keywords	skill system, create skill, add skill, skill triggers, skill rules, hook system, skill development
patterns	(how do|how does|explain).*?skill, (create|add|modify|build).*?skill, skill.*?(work|trigger|activate|system)

Skill Creator

Overview

The Skill Creator provides guidance for building skills that extend Claude's capabilities through specialized knowledge, workflows, and tool integrations. These modular packages function as "onboarding guides" for specific domains.

Key Components

Skills consist of a required SKILL.md file plus optional bundled resources:

• SKILL.md: Contains YAML metadata (name, description) and markdown instructions
• scripts/: Executable code for deterministic, reusable tasks
• references/: Documentation loaded into context as needed
• assets/: Output files like templates and icons

Design Principle

Skills employ progressive disclosure—metadata always loads (~100 words), SKILL.md triggers when relevant (<5k words), and bundled resources load on demand.

Creation Process

Step 1: Gather concrete usage examples to understand functionality requirements.

Step 2: Analyze examples to identify reusable resources (scripts, references, assets).

Step 3: Run scripts/init_skill.sh <skill-name> --path <path> to generate the skill template structure.

Step 4: Edit the skill using imperative language, focusing on procedural knowledge beneficial to another Claude instance.

Step 5: Iterate based on real-world testing feedback.

Best Practices

Write in imperative form rather than second person. Keep SKILL.md lean by moving detailed information to references files. Include scripts for repeatedly-written code. Avoid duplicating information across files.

Available Scripts

init_skill.sh

Creates a new skill from template with proper directory structure and example files.

Usage:

.claude/skills/skill-creator/scripts/init_skill.sh <skill-name> --path <path>

Example:

.claude/skills/skill-creator/scripts/init_skill.sh my-new-skill --path .claude/skills

quick_validate.sh

Validates skill structure and metadata.

Usage:

.claude/skills/skill-creator/scripts/quick_validate.sh <skill_directory>

Example:

.claude/skills/skill-creator/scripts/quick_validate.sh .claude/skills/my-skill