Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.
Design & media
skill-kit
Try itManage 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
| 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 |
| graph | Extract depends-on + topic body Skill(...) edges into Edge Table + Mermaid + dispatched d3 force-directed render | graph.md |
| language | Enforce per-skill language consistency (description-language rule + Edit/Write pre-check) | language.md |
| lint | Validate and fix SKILL.md frontmatter | lint.md |
| merge | Combine related skills into one | merge.md |
| portability | public/published skill cross-ref + vendor-specific isolation rules | portability.md |
| publish-scope | published skill scope check before adding topics/scripts | publish-scope.md |
| route | Recommend topic placement within skills (plugin-level clustering → cc-plugin/clustering) | 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 |
| invoke-discipline | Slash command → Skill tool call, multi-topic Read, post-decision auto-invoke, interactive script, vendor dispatch | invoke-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, 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 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:
- 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
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
Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.
Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.
Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.
Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.
Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.
More from drumrobot
Browse all skillsRun a 4-stage research → plan → review → TDD-implement workflow for code changes with optional PR capture.
Manage Claude Code sessions: lookup, search, repair, migration, compression, and cleanup in one command surface.
Manage Git worktrees, ghq clones, SourceGit registration, and multi-account credentials with safety checks.
Diagnose agent mistakes, harden the prompt that caused them, and finish the original task.
Convert plans and code changes into GitHub issues and PRs, with auth handling, dependency tracking, and pre-publish scans.
Convert functionality into Claude Code automations (Agent, Skill, Rule, Hook, Command)