Skills Router

A UserPromptSubmit hook for Claude Code that automatically matches user prompts to relevant skills using a combination of TF-IDF scoring, bigram matching, and configurable intent mapping.

How it works

1. On every prompt, the hook receives the user's message
2. Tokenizes the prompt (supports Latin + German umlauts/ß)
3. Scores every skill in the index using TF-IDF-weighted term matching and bigram proximity
4. Checks the configurable intent map for explicit trigger → skill overrides
5. Outputs matched skills to stderr for Claude to pick up

Scoring Algorithm

Scores are normalized by √(token count) to prevent long prompts from inflating scores.

Setup

# 1. Clone or copy to your machine
git clone <repo-url> ~/.claude/skills/skills-router

# 2. Build the skills index
node ~/.claude/skills/skills-router/src/build-index.js -v

# 3. Install the hook
node ~/.claude/skills/skills-router/src/install.js

# 4. (Optional) Customize config
cp ~/.claude/skills/skills-router/config.example.json ~/.claude/skills-router.config.json
# Edit ~/.claude/skills-router.config.json to add your own intents, stopwords, etc.

Configuration

Copy config.example.json to ~/.claude/skills-router.config.json and customize:

{
  "skillsDirs": ["~/.claude/skills"],
  "archiveDirs": ["~/.claude/skills-archive"],
  "indexPath": "~/.claude/skills-index.json",
  "maxResults": 5,
  "minScore": 1.5,
  "cacheTTL": 300000,
  "debug": false,
  "intents": {
    "bug": ["systematic-debugging"],
    "deploy": ["deploy-to-vercel"]
  }
}