Skill-Kit#

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

Commands#

CommandDescriptionLinkarchitectureMulti-topic skill structure and topicsarchitecture.mdconvertConvert agents or scripts to skillsconvert.mddedupIdentify and merge duplicate skillsdedup.mdfindDiscover and install skills via npx skills CLIfind.mdgraphExtract depends-on + topic body Skill(...) edges into Edge Table + Mermaid + dispatched d3 force-directed rendergraph.mdlanguageEnforce per-skill language consistency (description-language rule + Edit/Write pre-check)language.mdlintValidate and fix SKILL.md frontmatterlint.mdmergeCombine related skills into onemerge.mdportabilitypublic/published skill cross-ref + vendor-specific isolation rulesportability.mdpublish-scopepublished skill scope check before adding topics/scriptspublish-scope.mdrouteRecommend topic placement within skills (plugin-level clustering → cc-plugin/clustering)route.mdtriggerRegister triggers and generate hookstrigger.mdupgradeEnhance existing skills or add topicsupgrade.mdwriterInteractive skill creation wizardwriter.mdinvoke-disciplineSlash command → Skill tool call, multi-topic Read, post-decision auto-invoke, interactive script, vendor dispatchinvoke-discipline.md

Core Workflows#

Creation (skill-writer)#

Always use writer to ensure correct frontmatter and structure.

bash

/skill-kit writer                  # Start wizard

Maintenance (upgrade/lint)#

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

bash

/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)#

bash

/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)#

bash

/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:

StepUser InteractionWorkflowStep 1: Auto-detectAskUserQuestion (multiSelect)Summary info to .ralph/improvements.mdStep 1.5: Merge logic / Structure-improvements.md recordingStep 2: RequirementsAskUserQuestionTrigger/scope recommendation to improvements.mdStep 3: Type recommendationRecommend onlyimprovements.md recordingStep 4: ImplementationDirect actionPROHIBITED - Use [NEEDS_REVIEW] tagStep 5: ValidationValidationAuto 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