gitwtfhub

wtf is skill-router?

pcx-wave/skill-router — explained in plain English

Analysis updated 2026-05-18

15Audience · developerComplexity · 1/5LicenseSetup · easy

TL;DR

Meta-skill for Claude Code that indexes every installed skill once per session and routes each user request to the best match, with a suggest or silent auto mode.

Mindmap

mindmap
  root((skill-router))
    Inputs
      Installed skills
      User requests
    Outputs
      Routed skill
      Usage stats
      Attribution tag
    Use Cases
      Pick the right skill
      Audit unused skills
      Silent auto routing
    Tech Stack
      Markdown
      Claude Code
      JSON

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Auto-route a Claude Code request to the single best installed skill instead of loading everything.

REASON 2

Audit which Claude Code skills you actually use via /skill-router stats and remove the dead ones.

REASON 3

Switch between suggest mode and silent --auto routing per session.

REASON 4

Index a large personal skill library once and answer simple questions without loading any skill.

What's in the stack?

MarkdownClaude CodeJSON

How it stacks up

pcx-wave/skill-router0rnot/god-mode-claude13127905/deep-learning-based-air-gesture-text-recognition-
Stars151515
LanguagePython
Setup difficultyeasyeasymoderate
Complexity1/51/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

The index is session-only and may reset under context compression in very long sessions.

MIT license, you can use, modify, and ship it in commercial work as long as you keep the copyright notice.

Wtf does this do

skill-router is a meta-skill for Claude Code, which is Anthropic's command line coding assistant. In Claude Code you can install separate skills, each one a small Markdown file that gives the assistant extra know-how for a particular task such as writing tests, doing SEO audits, or handling deployments. People who collect many skills can end up with dozens or even hundreds installed, and then forget which one fits the current question. The router is meant to solve that. When activated, it scans every installed skill once per session, builds a lightweight index, and then watches incoming requests. If the request is a simple question it answers directly with no skill loaded. If the request clearly matches one skill in the index it either suggests that skill and asks before loading, or routes silently and just appends a small attribution like "(via skill-name)" to the answer. Only one skill is used per request, and weak or ambiguous matches are ignored to avoid noise. Installation is a single command that downloads the SKILL.md file into the user's Claude skills folder. The README lists four commands: /skill-router on for suggest mode, /skill-router on --auto for silent routing, /skill-router status to see what is indexed, and /skill-router stats to see which skills get used. Usage counts are stored in a JSON file under ~/.claude so you can later spot skills you never use and remove them. The author notes the index is session-only and may reset under context compression in very long sessions. The license is MIT.

Yoink these prompts

Prompt 1
Install pcx-wave/skill-router into my Claude Code skills folder and turn on silent auto routing. Show the one-line install and the /skill-router on --auto call.
Prompt 2
Run /skill-router stats and write a short script that flags any skill with zero uses over the last 30 days.
Prompt 3
Explain how skill-router scores ambiguous matches and what threshold causes it to skip routing entirely.
Prompt 4
Extend skill-router so the per-skill usage count survives across sessions in a SQLite file instead of plain JSON. Outline the schema and migration.
Prompt 5
Compare /skill-router on versus /skill-router on --auto on a session with 80 installed skills. List the user-visible differences.

Frequently asked questions

wtf is skill-router?

Meta-skill for Claude Code that indexes every installed skill once per session and routes each user request to the best match, with a suggest or silent auto mode.

What license does skill-router use?

MIT license, you can use, modify, and ship it in commercial work as long as you keep the copyright notice.

How hard is skill-router to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is skill-router for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.