explaingit

pcx-wave/skill-router

★ 15Audience · developerComplexity · 1/5ActiveLicenseSetup · easy

TLDR

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

Things people build with this

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

Tech stack

MarkdownClaude CodeJSON

Getting it running

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.

In plain English

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.

Copy-paste 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.
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.