skill-router

Routes agent queries to matching skills using a CLI search engine over SKILL.md files.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/amirbiron/claude-skills --skill skill-router-amirbiron
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-router
Source: https://github.com/amirbiron/claude-skills/tree/main/skills/skill-router
Command: npx skills add https://github.com/amirbiron/claude-skills --skill skill-router-amirbiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents with hundreds of installed skills waste context budget listing them all, and often fail to find the right skill for a request. This Skill routes any user request to the best-matching skill in under 50ms by querying a local index of SKILL.md files. ## Core Features & Use Cases - Skill Search Routing: Runs the skrt query CLI command to search an indexed skill library and returns ranked JSON results with scores and file paths. - 7-Strategy Matching: Combines exact name match, containment, keyword overlap, fuzzy Levenshtein, and CJK bigram matching, with optional AI embedding providers (Gemini, OpenAI, local endpoints) for reranking. - Pinned Skills & Smart Pin: Boosts priority skills in results and analyzes chat history to suggest which skills to pin. - Use Case: A user asks "用NotebookLM查找资料" — the agent runs skrt query, receives nlm-skill as the top match, reads that skill's SKILL.md, and follows its instructions. ## Quick Start When no loaded skill matches my request, run skrt query with my request text, then read the top result's SKILL.md and follow its instructions.

Frequently Asked Questions about skill-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the right skill for an agent request?

Run skrt query followed by the user's request text. The command returns JSON with ranked skills, scores, and paths; read the top result's SKILL.md file and follow its instructions to complete the task.

What is the skrt CLI and how does skill routing work?

skrt is a Go-based CLI that indexes SKILL.md files from configured directories and matches queries using seven strategies including exact match, keyword overlap, fuzzy Levenshtein, and CJK bigrams. Typical latency is under 50ms for 200+ skills.

Does skill search support Chinese or Japanese queries?

Yes, the matching engine includes CJK bigram matching for full Chinese, Japanese, and Korean support. Mixed-language queries like "用NotebookLM查找" return correctly ranked results.

Can I use AI embeddings instead of keyword matching for skill search?

Yes, configure an API provider with skrt provider setup to use Gemini or OpenAI embedding models for reranking. API keys are stored in ~/.skrt/credentials with owner-only permissions, and the tool falls back to keyword results if the API fails.

What should I do when skill search returns no results?

If results are empty or scores fall below 30, the library has no matching skill. Proceed with general knowledge, suggest installing a relevant skill, or run skrt index --force to rebuild the index after adding new skills.