- name
- skill-kit
- metadata
- author
- es6kr
- version
- 0.1.2
- description
- Claude Code skill management. writer - create new skills [writer.md], lint - validate and fix frontmatter [lint.md], merge - combine related skills [merge.md], dedup - find duplicate skills [dedup.md], convert - convert agents to skills [convert.md], architecture - multi-topic skill structure [architecture.md], upgrade - enhance existing skills, add topics [upgrade.md], route - recommend topic placement [route.md], trigger - declare SKILL.md triggers - auto-generate and register hooks [trigger.md]. Use when "skill writer", "skill lint", "skill merge", "skill dedup", "create skill", "frontmatter fix", "combine skills", "multi-topic skill", "agent to skill", "convert agent", "skill improve", "skill upgrade", "skill fix", "fix skill", "update skill", "add topic", "topic routing", "topic placement", "where to put", "topic route", "trigger compile", "compile triggers", "hook auto register", "trigger list".
Skill-Kit
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 |
| 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 wizardMaintenance (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 onlyImprovement 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, ordescription
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 onlyDeclare triggers in SKILL.md -> auto-generate hook scripts -> auto-register in settings.json.
Success Case
Scenario (2026-03-09):
- Found 3 openclaw-related functions
- Proposed 3 options for merging
- Result: Implementation success, user satisfied
Key factors:
- Identification of 3 functions
- "Merge?" AskUserQuestion
- 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:
- Identify failure and workaround patterns
- If candidates found, run
/skill-kit upgrade skill-kit