Design & media

skill-kit

Try it

Manage the full lifecycle of Claude Code skills: create, lint, merge, convert, upgrade, and discover them.

What it does

skill-kit bundles commands for every stage of skill maintenance. The interactive writer scaffolds a new SKILL.md, lint repairs frontmatter, merge and dedup consolidate related skills, and upgrade adds topics or scripts. Other commands convert agents into skills, auto-register trigger hooks into settings.json, search the open skills ecosystem via the npx skills CLI, and render dependency edges as Mermaid or a dispatched d3 force-directed graph. When `.ralph/` is present, Ralph Mode bypasses AskUserQuestion prompts, and a self-improvement step feeds conversation patterns back into the toolkit.

When to use it

  • Scaffold a new skill from scratch with frontmatter guidance
  • Validate or fix SKILL.md frontmatter, triggers, and depends-on
  • Merge duplicate skills or convert an agent into a skill
  • Find installable skills via the npx skills CLI

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

Questions people ask

Can it generate hooks automatically?
Yes. Declaring `triggers` in a SKILL.md lets `trigger compile` scan skills, generate dispatcher scripts, and register them in `settings.json`. A `dry-run` mode previews the result first.
Does it work without the interactive prompts?
When a `.ralph/` directory is present, skill-kit switches to Ralph Mode, summarizes decisions into `.ralph/improvements.md`, and uses `[NEEDS_REVIEW]` tags instead of asking via AskUserQuestion.
How are skill dependencies visualized?
The `graph` command extracts `depends-on` and `Skill(...)` references from topic bodies into an Edge Table, plus a Mermaid diagram and a dispatched d3 force-directed render.

Related skills

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.

by Iván535 installs31 stars

More from drumrobot

Browse all skills

Run a 4-stage research → plan → review → TDD-implement workflow for code changes with optional PR capture.

by drumrobot27 installs

Manage Claude Code sessions: lookup, search, repair, migration, compression, and cleanup in one command surface.

by drumrobot26 installs

Manage Git worktrees, ghq clones, SourceGit registration, and multi-account credentials with safety checks.

by drumrobot26 installs

Diagnose agent mistakes, harden the prompt that caused them, and finish the original task.

by drumrobot25 installs

Convert plans and code changes into GitHub issues and PRs, with auth handling, dependency tracking, and pre-publish scans.

by drumrobot18 installs

Convert functionality into Claude Code automations (Agent, Skill, Rule, Hook, Command)

by drumrobot17 installs