Skill Kit

Claude Code skill management. Topics — writer (create), lint (validate + fix frontmatter), merge (combine related), dedup (find duplicates), convert (agent → skill), architecture (multi-topic structure), upgrade (enhance + add topics), route (topic placement), trigger (declare + auto-register hooks), find (discover via npx skills CLI). Use when: "skill writer", "skill lint", "skill merge", "skill dedup", "create skill", "frontmatter fix", "multi-topic skill", "convert agent", "skill upgrade", "add topic", "topic route", "trigger compile", "hook auto register", "find skill", "discover skill", "npx skills", "skills.sh", "install skill".

Comprehensive toolkit for creating, managing, and maintaining Claude Code skills.

Commands

Command	Description	Link
architecture	Multi-topic skill structure and topics	architecture.md
convert	Convert agents or scripts to skills	convert.md
dedup	Identify and merge duplicate skills	dedup.md
find	Discover and install skills via npx skills CLI	find.md
lint	Validate and fix SKILL.md frontmatter	lint.md
merge	Combine related skills into one	merge.md
route	Recommend topic placement within skills	route.md
trigger	Register triggers and generate hooks	trigger.md
upgrade	Enhance existing skills or add topics	upgrade.md
writer	Interactive skill creation wizard	writer.md

Core Workflows

Creation (skill-writer)

Always use writer to ensure correct frontmatter and structure.

/skill-kit writer                  # Start wizard

Maintenance (upgrade/lint)

Use upgrade to add new functionality or topics to an existing skill.

/skill-kit upgrade skill-name      # Interactive upgrade
/skill-kit lint skill-name         # Validation only

Improvement types:

• Add Topic: Add documentation for a new sub-feature
• Add Script: Add logic to scripts/ and reference in SKILL.md
• Fix Frontmatter: Correct triggers, depends-on, or description

Trigger (Auto-generate Hooks)

/skill-kit trigger compile     # Scan skills -> generate dispatcher -> register in settings.json
/skill-kit trigger list        # List registered triggers
/skill-kit trigger dry-run     # Preview only

Declare triggers in SKILL.md -> auto-generate hook scripts -> auto-register in settings.json.

Detailed guide

Find (Discover via npx skills)

/skill-kit find <query>        # Search the open skills ecosystem via npx skills CLI

Searches the skills.sh leaderboard and ecosystem for installable skills. Use when looking for an existing skill rather than building one from scratch.

Detailed guide

Success Case

Scenario (2026-03-09):

• Found 3 openclaw-related functions
• Proposed 3 options for merging
• Result: Implementation success, user satisfied

Key factors:

1. Identification of 3 functions
2. "Merge?" AskUserQuestion
3. Merging skills using skill-writer (multi-topic)

Ralph Mode (AskUserQuestion bypass)

If .ralph/ directory exists, operate in Ralph Mode.

Workflow Change:

Step	User Interaction	Workflow
Step 1: Auto-detect	AskUserQuestion (multiSelect)	Summary info to .ralph/improvements.md
Step 1.5: Merge logic / Structure	-	improvements.md recording
Step 2: Requirements	AskUserQuestion	Trigger/scope recommendation to improvements.md
Step 3: Type recommendation	Recommend only	improvements.md recording
Step 4: Implementation	Direct action	PROHIBITED - Use [NEEDS_REVIEW] tag
Step 5: Validation	Validation	Auto validation (after changes are complete)

Self-Improvement

After changes are complete, Self-improve based on conversation:

1. Identify failure and workaround patterns
2. If candidates found, run /skill-kit upgrade skill-kit