Skip to main content
skill CX Codex

skill-router · dotslashsimran — Claude Code skill for choosing and chaining skills

The skill-router Claude Code skill selects a matching skill or builds a sequence for a task. It kicks in when a request is vague or could call for several skills.

MIT ★ 541 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dotslashsimran/simcraft --skill skill-router -a claude-code
Open on GitHub

What skill-router does

skill-router compares the task with installed skill descriptions, checking whether each candidate fits the trigger, available input, and expected output. It discovers skills by running catalog.py instead of relying on memory. The script requires python3.

For multi-stage work, the router passes each stage’s output to the next skill and caps the chain at three. It presents a short plan before work begins. If an unclear goal, input, or deliverable would change the choice, it asks one question; if no skill fits, it handles the task directly.

What it helps with

  • choose a skill for a vague task
  • match installed skills to an input and expected deliverable
  • connect distinct stages through explicit handoffs
  • avoid chaining skills that do the same job

Example prompts for the agent

  • Choose the right skill for this task and outline the steps.
  • Find skills for each stage, then run them in order.
  • Check whether any installed skill fits, and do the task directly if none does.

How to install skill-router

1Skills CLI (Vercel)

npx skills add dotslashsimran/simcraft --skill skill-router -a claude-code

2Manually: put the files in place

~/.claude/skills/skill-router/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-router/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about skill-router

How do I install skill-router in Claude Code?

Run npx skills add dotslashsimran/simcraft --skill skill-router -a claude-code. The skill file is at ~/.claude/skills/skill-router/SKILL.md.

What does skill-router do?

It matches a task against installed skill descriptions and chooses one skill or a chain of up to three. It shows a plan first and passes each stage’s output to the next.

What happens if no installed skill fits the task?

The router handles the task directly instead of forcing a match. It scans the skill catalog by running catalog.py with python3.

Source text

SKILL.md · MIT
---
name: skill-router
description: Decide which installed skill, or which chain of two or three skills, fits a task before starting it, and run them in the right order with each one's output feeding the next. Works with any set of skills, because it reads every installed skill's description at run time. Use when a task is big or vague, could fit several skills, or needs more than one ("which skill should I use", "what's the best way to do this", "plan the steps", "use whatever skills make sense"), or when it's unclear whether any skill applies.
---

# Skill router

Pick the right tool before working. One skill done well beats three loosely chained, so prefer one skill, use two when the task truly has two stages, and use three only for a full pipeline.

## 1. See what's installed

```
python3 ~/simcraft/skills/planning/skill-router/scripts/catalog.py            # every skill, with its description
python3 ~/simcraft/skills/planning/skill-router/scripts/catalog.py --grep video
```

Always run it rather than relying on memory. Skills get added and removed, and the description is the contract.

## 2. Pin down the task

Write one line each for:
- **Goal:** what the user wants to be true at the end.
- **Input:** what exists now (a file, a URL, a repo, a vague idea).
- **Deliverable:** the exact artifact (a video, a report, a fixed bug, a doc).

If any of these is unclear and the answer would change the skill choice, ask one question. Otherwise decide.

## 3. Match

For each candidate skill, check three things against its description:
1. **Trigger fit.** Does the task match what it says it's for, not just share a keyword?
2. **Input fit.** Does it accept what the user has?
3. **Output fit.** Does it produce the deliverable, or something the next skill needs?

Keep only skills that pass all three for their part of the work. When two skills overlap, choose the more specific one (a skill made for the exact format beats a general one). If nothing fits, say so and do the task directly. A forced match is worse than none.

## 4. Decide: one, two or three

- **One skill** when it goes from the input to the deliverable on its own.
- **A chain** when the work has distinct stages and each stage has its own best skill. Typical shapes:
  - **understand → make:** analyse something first, then build from what was learned.
  - **make → check:** build, then audit or review it with a separate skill.
  - **raw → clean → finish:** e.g. trim footage, clean the audio, then add graphics.
- Write the chain as a handoff: what each skill produces, and which file or fact the next one takes as input. If a step has no clear handoff, the chain is wrong.
- Never run two skills that do the same job, and never add a skill just because it is related.

## 5. Show the plan, then run

Show the user a short plan before starting anything heavy:

```
Task: <one line>
Plan: <skill A> (<what it gives>) → <skill B> (<what it does with it>)
Why not <closest alternative>: <one line>
```

Then load each skill with the Skill tool in order, follow its instructions fully, and check each handoff before moving on. If a stage's output is weak, fix it there rather than letting the next skill build on it.

## Examples of good chains

These use skills from this repo. The method is the same for any skill set.

| Task | Plan |
|---|---|
| "Remake this viral clip in my style" | reverse-engineer-video (shot list, camera moves, beat map) → perspective-illusion or code-loop (build it) |
| "Turn this paper into a video" | paper-to-runnable (working code + internals animation) → vox-explainer (explainer over a voiceover) |
| "Audit this SDK and show it" | dx-audit (friction log, teardown) → scripted-screencast (recorded journey) |
| "Clean up my talking-head take" | rough-cut → clean-audio |
| "Is this new endpoint safe and well designed?" | api-design-review → security-threat-model |
| "It got slower last week" | benchmark-honestly (a trustworthy oracle) → bisect-anything (find the commit) |
| "I just joined this repo, fix the flaky CI" | codebase-map → flaky-test-killer |
| "Make a branded explainer for a sponsor" | brand-kit → vox-explainer |

## Mistakes to avoid

- Picking by keyword ("video" in the request) instead of by deliverable.
- Chaining when one skill already covers both stages.
- Skipping a stage's own checks to get to the next skill faster.
- Forgetting a skill's safety rules when it runs inside a chain. Each skill's rules still apply in full.

© dotslashsimran · MIT · dotslashsimran/simcraft

Similar skills

All skills for Agent setup: memory, context, orchestration →

skill-router by other authors comes first.

skill-router zhaono1 skill-router reads your request and points to the narrowest matching skill from the catalog. Handy when you don't know which tool fits the job. CX Codex +1 896installs skill-router Rohit Ghumare The skill-router skill maps pro-workflow skills and commands to jobs, with guidance on when to use each and whether a person or the agent starts it. Use it when you’re unsure what fits. CX Codex +1 ★ 2,966repo stars clerk-react-router-patterns clerk clerk-react-router-patterns guides Clerk integration with React Router v7/v8, including loaders, protected routes, SSR auth, and organization switching. Useful when wiring auth into a router. CX Codex +1 16,300installs router gamedev-skills The router Claude Code skill selects game-development skills based on the project engine and the requested work. It runs at the start of a game-building or debugging request. CX Codex +1 12,900installs wordpress-router WordPress wordpress-router identifies the structure of a WordPress codebase and directs the agent to the appropriate workflow. Useful before starting work on plugins, themes, or core checkouts. CX Codex +1 6,500installs rust-router actionbook rust-router — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that routes every Rust question through three cognitive layers: language mechanics, design patterns, domain constraints. CX Codex +1 3,100installs nextjs-app-router-fundamentals wsimmonds nextjs-app-router-fundamentals — a skill that walks the agent through Next.js App Router: Pages Router migration, nested layouts, metadata, dynamic routes. Useful when moving to app/. CX Codex +1 2,200installs reverse-skill-router zhaoxuya520 reverse-skill-router — a skill for Claude Code and Codex that routes reverse engineering and defensive security tasks into the reverse-skill framework. Activates on binary analysis, CTF challenges, and vulnerability audits. CX Codex +1 1,800installs

From the same set24

The whole set →
next-step The next-step Claude Code skill turns a large goal or an unstructured task dump into one next action. It activates for planning requests or when someone is unsure how to begin. CX Codex +1 ★ 541repo stars from-scratch The from-scratch Claude Code skill teaches how a technology works by building a small version step by step. Before each run, the agent asks for a prediction, then checks it against the program’s output. CX Codex +1 ★ 541repo stars video-script The video-script Claude Code skill drafts short talking-head, explainer, and product-demo videos. It activates for requests to write or revise a script, hook, or YouTube, TikTok, Reels, or LinkedIn video. CX Codex +1 ★ 541repo stars repo-timelapse The repo-timelapse Claude Code skill turns a repository’s Git history into a video of the project changing over time. It runs on requests to show project growth or animate commits. CX Codex +1 ★ 541repo stars bisect-anything The bisect-anything Claude Code skill tracks a regression to a commit, dependency version, or config value. It activates for requests to find what broke a test or when a problem began. CX Codex +1 ★ 541repo stars scripted-screencast The scripted-screencast Claude Code skill turns scripted browser actions into a product demo video with cursor effects, zooms, and captions. It activates for screencast requests and rerenders after interface changes. CX Codex +1 ★ 541repo stars security-threat-model The security-threat-model Claude Code skill maps threats from an app’s code and tests the highest risks locally. It activates for requests about STRIDE, app security reviews, or vulnerabilities before launch. CX Codex +1 ★ 541repo stars vox-explainer The vox-explainer Claude Code skill makes Vox-style explainer graphics or a faceless video. It runs on requests for voiceover-led visuals, animated quotes, or stats. CX Codex +1 ★ 541repo stars

Project sponsors

Companies that keep this analytics open