Skill Router — AI skill for Claude Code

skill-router

[](https://github.com/hussi9/skill-router/stargazers) [](LICENSE) [](https://github.com/hussi9/skill-router/actions)

**Your skill first, the process skill second, gates and memory on the card — before any tool fires.**

A hook-driven router for Claude Code. It indexes every skill you have installed by *when it applies*, ranks them against each prompt in ~80 ms, asks a small model only when the ranking is unsure, and injects a route card before Claude's first action. Enforcement is tiered: hard where a wrong skill is expensive, soft everywhere else. The route follows every sub-agent you dispatch.

> my macbook restarted again last night, can you check why
[skill-router] This is a BROKEN task — 2-step chain.
[skill-router] Chain: mac-doctor → superpowers:systematic-debugging
[skill-router] Invoke step 1/2 now:
▶ mac-doctor  (inherit, in-session)
▶ superpowers:systematic-debugging  (inherit, in-session)
[skill-router] Memory: airbook_crash_root_cause  (read from ~/.claude/projects/.../memory/)
[skill-router] IRON RULE: call Skill(skill="mac-doctor") before any Edit/Write/Task.

Every line is `[skill-router]`-prefixed, so `grep '\[skill-router\]'` on a transcript shows exactly what was routed.

Why (v4, September 2026)

An audit of this machine after five months of use:

Finding	Number
Skills installed / ever invoked / invoked last month	291 / 80 / 32
Tokens the skill listing cost every session start	~22,600
Skills the v3 routing table could name	~20 (all process skills)
Real prompts the v3 router answered with silence	4 of 10
writing-plans announced / followed	6 / 1
Months routing was dead without anyone noticing	2

The routing table could never enumerate the domain skills — t