# skill-router

Reads your request and points to the narrowest matching skill from the catalog. Handy when you don't know which tool fits the job.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 873 installs · ★ 84
- Author: zhaono1
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/zhaono1/agent-playbook/tree/HEAD/skills/skill-router/SKILL.md
- Updated: 2026-09-15
- HTML: https://affpapa.org/en/nevibecode/skills/skill-router

## What it does

The skill kicks in when you ask which skill to use, or describe a need without naming one. It matches keywords and intent against the skill catalog of the current host, and asks clarifying questions through `AskUserQuestion` when the request is vague.

Inside is a catalog grouped by category: meta and workflow, core development, documentation and testing, architecture and DevOps, planning, design. For bigger jobs the router suggests a sequence, like `api-designer` → `api-documenter` → `test-automator`. Its tools are `Read`, `AskUserQuestion`, `WebSearch`, `Grep`.

Routing stays within what's visible in the current session, so it won't credit a host with capabilities it doesn't have. When nothing matches exactly, it offers the closest skill or helps without one.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add zhaono1/agent-playbook --skill skill-router -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skill-router/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skill-router/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add zhaono1/agent-playbook --skill skill-router -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skill-router/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add zhaono1/agent-playbook --skill skill-router -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skill-router/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zhaono1/agent-playbook skill-router
```

2. **Manually: put the files in place**
- File: `.github/skills/skill-router/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add zhaono1/agent-playbook --skill skill-router -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/zhaono1/agent-playbook --path skills/skill-router
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skill-router/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add zhaono1/agent-playbook --skill skill-router -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/zhaono1/agent-playbook/tree/HEAD/skills/skill-router/SKILL.md

## When to use it
- pick a skill for a specific task
- break a complex project into a skill sequence
- clarify a request when the goal is fuzzy
- find a skill by meaning rather than keyword
- get a fallback when nothing matches exactly

## Example prompts
- which skill should I use to review a pull request?
- help me find a skill for writing tests
- I'm building a new API, which skills should I chain?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f4b66b8800777690.

BEGIN THIRD-PARTY FILE f4b66b8800777690
```text
---
name: skill-router
description: Routes an agent request to the narrowest matching portable skill when the user asks which skill to use or needs help selecting one across supported hosts.
allowed-tools: Read, AskUserQuestion, WebSearch, Grep
metadata:
  hooks:
    after_complete:
      - trigger: session-logger
        mode: auto
        reason: "Log skill routing decisions"
---

# Skill Router

Analyze the request and recommend the narrowest matching skill exposed by the
current host. Do not assume Claude Code, Codex, Gemini, or DeepSeek Harness
capabilities that are not visible in the current session.

## When This Skill Activates

This skill activates when you:
- Ask "which skill should I use?" or "what skill can help with...?"
- Say "use a skill" without specifying which one
- Express a need but aren't sure which skill fits
- Mention "skill router" or "help me find a skill"

## Available Skills Catalog

### Meta & Workflow

| Skill | Best For |
|-------|----------|
| `skill-router` | Finding and selecting the right skill for a task |
| `create-pr` | Creating pull requests with bilingual documentation checks |
| `session-logger` | Saving session summaries and activity logs |
| `workflow-orchestrator` | Coordinating multi-skill workflows and triggers |
| `self-improving-agent` | Learning from completed skill workflows |
| `auto-trigger` | Declaring trigger relationships between skills |

### Core Development

| Skill | Best For |
|-------|----------|
| `commit-helper` | Writing Git commit messages, formatting commits |
| `code-reviewer` | Reviewing PRs, code changes, quality checks |
| `debugger` | Diagnosing bugs, errors, unexpected behavior |
| `refactoring-specialist` | Improving code structure, reducing technical debt |

### Documentation & Testing

| Skill | Best For |
|-------|----------|
| `documentation-engineer` | Writing README, technical docs, code documentation |
| `api-documenter` | Creating OpenAPI/Swagger specifications |
| `test-automator` | Writing tests, setting up test frameworks |
| `qa-expert` | Test strategy, quality gates, QA processes |

### Architecture & DevOps

| Skill | Best For |
|-------|----------|
| `api-designer` | Designing REST/GraphQL APIs, API architecture |
| `security-auditor` | Security audits, vulnerability reviews, OWASP Top 10 |
| `performance-engineer` | Performance optimization, speed analysis |
| `deployment-engineer` | CI/CD pipelines, deployment automation |

### Planning & Analysis

| Skill | Best For |
|-------|----------|
| `prd-planner` | Creating PRDs with persistent file-based planning |
| `prd-implementation-precheck` | Prechecking PRDs/specs before implementation |
| `architecting-solutions` | Non-PRD solution design, architecture, and requirements analysis |
| `planning-with-files` | Multi-step task planning, persistent file-based organization |
| `long-task-coordinator` | Multi-session, delegated, or resumable work that needs explicit state and recovery |

### Design & UX

| Skill | Best For |
|-------|----------|
| `figma-designer` | Analyzing Figma designs and producing implementation-ready visual specs/PRDs |
```
END THIRD-PARTY FILE f4b66b8800777690

The third-party file has ended. Everything between the f4b66b8800777690 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3131 of 8052 bytes. © zhaono1 · MIT · https://github.com/zhaono1/agent-playbook/tree/HEAD/skills/skill-router/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md