Agent skill

Skill Router

by majiayu000 in majiayu000/claude-skill-registry

This skill should be used when the user has a vague or cross-domain request and asks "which skill should I use", "is there a skill for this", "find the right skill", or "route this to the best…

MITAuto-check passed

Install Skill Router

skills CLI
$ npx skills add majiayu000/claude-skill-registry --skill skill-router -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install majiayu000/claude-skill-registry skill-router --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bash/skill-router .claude/skills/skill-router && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-router
GitHub stars
666
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
548 words
Files
2
Skills in repo
1,273
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user has a vague or cross-domain request and asks "which skill should I use", "is there a skill for this", "find the right skill", or "route this to the best…

  • Works in 4 steps: Run route_skill.py "" against the… → Review the ranked candidates and their… → Pick the top fit (or present the top 2-3… → …
  • Cross-domain request and asks which skill should I use
  • SKILL.md covers Overview, Use when, Clarify First and Quick Start, plus 4 more sections
  • Calls python

What it does

Skill Router is an agent skill from majiayu000/claude-skill-registry. This skill should be used when the user has a vague or cross-domain request and asks "which skill should I use", "is there a skill for this", "find the right skill", or "route this to the best skill" — it matches an intent against the whole skills library and recommends the best-fit skill(s).

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `metadata.json`).

It works with Bash. The repository describes itself as: Searchable Claude Code skills catalog with source-linked guides and generated registry artifacts. The licence is MIT.

When your agent uses it

  • Cross-domain request and asks which skill should I use
  • Is there a skill for this
  • Find the right skill
  • Route this to the best skill — it matches an intent against the whole skills library and recommends the best-fit skill(s)

Example prompts

  • “which skill should I use”
  • “is there a skill for this”
  • “find the right skill”
  • “/skill-router”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run route_skill.py "" against the generated catalog (cli/skills.json).
  2. Review the ranked candidates and their match reasons.
  3. Pick the top fit (or present the top 2-3 if genuinely ambiguous) and activate that skill — do not do the work in the router.
  4. If nothing scores well, say so plainly and suggest the closest domain rather than forcing a weak match.

What it can do on your machine

Read from SKILL.md and the folder at commit 2d14a69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Router loads about 1.2k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 548 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/claude-skill-registry at commit 2d14a69, republished under its MIT licence (© majiayu000). 548 words, ~1,167 tokens.

Download SKILL.mdSave it as .claude/skills/skill-router/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
skill-router
description
This skill should be used when the user has a vague or cross-domain request and asks "which skill should I use", "is there a skill for this", "find the right skill", or "route this to the best skill" — it matches an intent against the whole skills library and recommends the best-fit skill(s).
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
workflow
metadata.domain
orchestration
metadata.updated
2026-06-22
metadata.python-tools
route_skill.py
metadata.tags
router, discovery, orchestration, navigation, intent-matching

Skill Router

Overview

This library has hundreds of skills across sixteen domains. A user rarely knows the exact skill name — they know their intent ("I need to figure out what to build next quarter," "I have to respond to a data breach"). The router closes that gap: it matches a free-text request against every skill's description and tags, ranks the candidates, and recommends the best fit — so the right skill activates on the first try instead of the user grepping folders or guessing.

It is the user-invoked orchestrator in the two-tier model: it never does the work itself, it routes to the skill (the discipline) that does. Treat its output as a recommendation, then activate the chosen skill.

Use when

  • Vague intent — the user describes a goal but not which skill ("help me plan a launch").
  • Cross-domain ambiguity — the request could plausibly live in several domains (is "pricing" PM, finance, or business-growth?).
  • Discovery — the user asks whether a skill exists for X before assuming there isn't one.
  • Disambiguation — several similarly named skills exist (e.g. multiple PRD or CRO skills) and you need the closest match.

Clarify First

Before routing, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • The actual goal — the outcome the user wants, in their words (the router matches intent, so a vague goal yields vague matches)
  • Artifact vs advice — do they want to produce something or decide/understand something (separates generative skills from advisory ones)

Stop rule: if the request is already specific, skip the questions and route directly.

Quick Start

bash
# Recommend the best-fit skills for an intent
python scripts/route_skill.py "plan a go-to-market for a new B2B feature"

# Narrow to a domain, or widen the result set
python scripts/route_skill.py "respond to a data breach" --top 5
python scripts/route_skill.py "forecast revenue" --domain finance --format json
  1. Run route_skill.py "<the user's goal>" against the generated catalog (cli/skills.json).
  2. Review the ranked candidates and their match reasons.
  3. Pick the top fit (or present the top 2-3 if genuinely ambiguous) and activate that skill — do not do the work in the router.
  4. If nothing scores well, say so plainly and suggest the closest domain rather than forcing a weak match.
Show full SKILL.md (226 more words)Show less

How matching works

The script scores each skill by term overlap between the query and the skill's name, tags, domain, and description, weighting exact name/tag hits highest. It reads the catalog from cli/skills.json (regenerated by scripts/build_manifest.py), so it always reflects the current library without hardcoding any skill list.

Anti-patterns

  • Doing the work instead of routing. The router recommends; the recommended skill executes. Don't blur the two.
  • Forcing a match. If the top score is weak, say "no strong fit" — a confidently wrong route is worse than an honest miss.
  • Ignoring the artifact-vs-advice split. Routing a "produce a PRD" intent to an advisory persona (or vice-versa) wastes the user's time.
  • Hardcoding skill names. Always read the live catalog; the library changes.

Scope & Limitations

In Scope: Matching a free-text intent against the skills catalog and recommending the best-fit skill(s); disambiguating similar skills; confirming whether a skill exists for a goal.

Out of Scope: Executing the matched skill's workflow (that's the target skill's job); multi-skill workflow orchestration across a sequence (see standards/ orchestration protocol and agents/personas/); installing or extracting skills.

Dependency note: the router reads the repo-level catalog cli/skills.json. It is a navigation aid for use within the library, not a standalone single-skill download — if the catalog is absent, point the script at it with --catalog <path> or regenerate it with python scripts/build_manifest.py.

References

  • scripts/route_skill.py — intent-to-skill scorer over cli/skills.json.

© majiayu000, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/bash/skill-router of majiayu000/claude-skill-registry.

  • SKILL.md
  • metadata.json

Open the folder on GitHubat commit 2d14a69

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in majiayu000/claude-skill-registry, which our catalogue first saw on October 8, 2026.

Compare with similar skills

Skill Router next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Router compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Router this skillmajiayu000/claude-skill-registry6661 repos~1.2kAutomated safety check: PassMIT
Code Improvertrailofbits/skills7.4k—~1.8kAutomated safety check: NotesCC-BY-SA-4.0
Skill Improvertrailofbits/skills7.4k—~2.1kAutomated safety check: NotesCC-BY-SA-4.0
Skill Stocktakeaffaan-m/ECC275k—~1.4kAutomated safety check: PassMIT
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k11 repos~4.1kAutomated safety check: NotesApache-2.0
Plugin Settings Patternanthropics/claude-plugins-official38k7 repos~3kAutomated safety check: PassApache-2.0

Similar skills

  • Code Improver

    trailofbits/skills

    Official

    Runs an autonomous review-and-fix improvement loop over any code target — a skill, plugin, module, or directory — using a reviewer the user names: any installed skill or agent.

    7.4k GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Skill Improver

    trailofbits/skills

    Official

    Runs an autonomous review-and-fix improvement loop over a Claude Code skill until a review comes back clean, with a cross-round findings ledger, escalation when fixes stop converging, and a…

    7.4k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Skill Stocktake

    affaan-m/ECC

    Claudeのスキルとコマンドの品質を監査するためのツール。変更されたスキルのみを対象とした高速スキャンと、順次サブエージェントバッチ評価を使用した完全棚卸しモードをサポートする。

    275k GitHub stars~1.4k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 11 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed

More from majiayu000/claude-skill-registry

All 1,273 skills in this repo
  • Deep Research

    majiayu000/claude-skill-registry

    Multi-source deep research using firecrawl and exa MCPs. An agent skill from majiayu000/claude-skill-registry.

    666 GitHub starsUsed in 6 repos~1.1k tokens
    Auto-check passed
  • Exa Search

    majiayu000/claude-skill-registry

    Neural search via Exa MCP for web, code, and company research.

    666 GitHub starsUsed in 5 repos~856 tokens
    Auto-check passed
  • Fal AI Media

    majiayu000/claude-skill-registry

    Unified media generation via fal.ai MCP — image, video, and audio.

    666 GitHub starsUsed in 5 repos~1.7k tokens
    Auto-check passed
  • Pyzotero

    majiayu000/claude-skill-registry

    Interact with Zotero reference management libraries using the pyzotero Python client.

    666 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check: notes
  • Bgpt Paper Search

    majiayu000/claude-skill-registry

    Search scientific papers and retrieve structured experimental data extracted from full-text studies via the BGPT MCP server.

    666 GitHub starsUsed in 4 repos~619 tokens
    Auto-check: notes
  • Bio Alignment Pairwise

    majiayu000/claude-skill-registry

    Perform pairwise sequence alignment using Biopython Bio.Align.PairwiseAligner.

    666 GitHub starsUsed in 4 repos~1.7k tokens
    Auto-check passed

Works with

Questions about Skill Router

What does Skill Router do?

This skill should be used when the user has a vague or cross-domain request and asks "which skill should I use", "is there a skill for this", "find the right skill", or "route this to the best…. Skill Router is an agent skill from majiayu000/claude-skill-registry. This skill should be used when the user has a vague or cross-domain request and asks "which skill should I use", "is there a skill for this", "find the right skill", or "route this to the best skill" — it matches an intent against the whole skills library and recommends the best-fit skill(s).

When should I use Skill Router?

Skill Router fits situations like: cross-domain request and asks which skill should I use; is there a skill for this; find the right skill; route this to the best skill — it matches an intent against the whole skills library and recommends the best-fit skill(s).

How do I install Skill Router in Claude Code?

Run `npx skills add majiayu000/claude-skill-registry --skill skill-router -a claude-code`. Or copy the skill folder (skills/bash/skill-router in majiayu000/claude-skill-registry) into .claude/skills/skill-router in your project. Claude Code loads it when a task matches its description.

How do I install Skill Router in Codex?

Run `npx skills add majiayu000/claude-skill-registry --skill skill-router -a codex`. Or copy the skill folder (skills/bash/skill-router in majiayu000/claude-skill-registry) into .agents/skills/skill-router in your project. Codex loads it when a task matches its description.

Can I use Skill Router in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add majiayu000/claude-skill-registry --skill skill-router -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-router, .gemini/skills/skill-router, .github/skills/skill-router and .opencode/skills/skill-router in your project.

What does Skill Router need to run?

Going by SKILL.md and its folder, Skill Router needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Skill Router access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Router safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Router use?

Skill Router is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Router use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Router?

Skills that share tags, products or a category with Skill Router: Code Improver (trailofbits/skills, 7.4k stars), Skill Improver (trailofbits/skills, 7.4k stars), Skill Stocktake (affaan-m/ECC, 275k stars) and Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Router?

majiayu000 (a GitHub user) maintains it in majiayu000/claude-skill-registry, which has 666 GitHub stars. The repository holds 1,273 skills in this directory. The repository was last updated on October 7, 2026.

Source: majiayu000/claude-skill-registry on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.