Design & media

skill-kit

Try it

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), graph (extract depends-on + topic body Skill calls into Edge Table + Mermaid + dispatched d3 force-directed render), language (per-skill language consistency enforcement), portability (public skill cross-ref + vendor isolation), publish-scope (published skill scope review before extending), invoke-discipline (slash command → Skill tool call, multi-topic Read, post-decision auto-invoke, interactive script, vendor dispatch). 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

What it does

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), graph (extract depends-on + topic body Skill calls into Edge Table + Mermaid + dispatched d3 force-directed render), language (per-skill language consistency enforcement), portability (public skill cross-ref + vendor isolation), publish-scope (published skill scope review before extending), invoke-discipline (slash command → Skill tool call, multi-topic Read, post-decision auto-invoke, interactive script, vendor dispatch). 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", "skill graph", "skill dependency graph", "depends-on extract", "mermaid skill graph", "force-directed skill graph", "skill language", "description language", "portability", "publish scope", "slash command tool call", "Skill tool missing", "multi-topic read", "invoke discipline", "post-decision skill invoke", "interactive script".

The skill document

Skill-Kit

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

Commands

CommandDescriptionLink
architectureMulti-topic skill structure and topicsarchitecture.md
convertConvert agents or scripts to skillsconvert.md
dedupIdentify and merge duplicate skillsdedup.md
findDiscover and install skills via npx skills CLIfind.md
graphExtract depends-on + topic body Skill(...) edges into Edge Table + Mermaid + dispatched d3 force-directed rendergraph.md
languageEnforce per-skill language consistency (description-language rule + Edit/Write pre-check)language.md
lintValidate and fix SKILL.md frontmatterlint.md
mergeCombine related skills into onemerge.md
portabilitypublic/published skill cross-ref + vendor-specific isolation rulesportability.md
publish-scopepublished skill scope check before adding topics/scriptspublish-scope.md
routeRecommend topic placement within skills (plugin-level clustering → cc-plugin/clustering)route.md
triggerRegister triggers and generate hookstrigger.md
upgradeEnhance existing skills or add topicsupgrade.md
writerInteractive skill creation wizardwriter.md
invoke-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.

/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         # 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 InteractionWorkflow
Step 1: Auto-detectAskUserQuestion (multiSelect)Summary info to .ralph/improvements.md
Step 1.5: Merge logic / Structure-improvements.md recording
Step 2: RequirementsAskUserQuestionTrigger/scope recommendation to improvements.md
Step 3: Type recommendationRecommend onlyimprovements.md recording
Step 4: ImplementationDirect actionPROHIBITED - Use [NEEDS_REVIEW] tag
Step 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

Related skills

Agent skill recommender. Input a user need, task description, or existing skill list; output best matching skills, install rationale, duplicate/merge candida...

37 installs

Update installed agent skills with diff preview, backup, and rollback before any change is applied.

92 installs6 stars

Agent skill quality checker. Input a skill directory or skill files; output trigger clarity, metadata issues, examples, safety boundaries, installability, po...

36 installs

Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.

25 installs1 stars

Two-pass code audits across security, perf, UX, DX, and edge.

83 installs

Build high-quality Agent Skills for any agent - opinionated best practices distilled from the Agent Skills spec, official Anthropic guidance, and production experience. Covers SKILL.md structure, frontmatter, description writing, single-file vs references/ layout, progressive disclosure, testing, patterns, troubleshooting, and distribution across all surfaces (Claude.ai, Claude Code, API, Agent SDK). Use when creating a skill, reviewing skill quality, debugging why a skill won't trigger, structuring skill directories, or writing skill descriptions.

24 installs