skill-router
You cannot hold 41 skills and 23 commands in your head. This is the index so you do not have to. Each entry says what it is for and how it fires: [human] you invoke it deliberately, [auto] the agent reaches for it from your prompt.
Keep this honest. When a skill is added, renamed, removed, or changes how it fits a flow, update this file in the same change. A router that points at a skill that no longer exists, or omits a new one, is worse than none.
How to use it
State the job in one line. Match it to a group below. If two skills look close, the when to reach clause is the tiebreaker. Most skills have a matching slash command of the same name, so this index covers commands too.
Self-correction and memory
learn-rule [human] - capture a correction as a durable rule loaded on every future session.replay-learnings [auto] - surface past learnings relevant to the task before you start.insights [human] - correction trends, heatmaps, productivity view.skill-optimizer [human] - train a skill's SKILL.md against accumulated corrections.
Planning and decisions
plan-interrogate [human] - resolve every open decision before code; emits a decision ledger, a shared-language CONTEXT.md, and decision records.domain-modeling [human] - build the project's shared vocabulary and bounded contexts up front.improve-architecture [human] - audit an area and propose the smallest structural moves; plan, not rewrite.thoroughness-scoring [auto] - score each decision point 1-10 so effort tracks stakes.orchestrate [human] - wire commands, agents, and skills together for a multi-phase feature.
Multi-agent and parallel work
agent-teams [human] - lead plus teammates sharing one task list.batch-orchestration [human] - split a large change into independent units, one agent each.parallel-worktrees [human] - git worktrees for zero-dead-time parallel sessions.sprint-status [human] - status across active parallel sessions.
Context and tokens
context-engineering [human] - Write, Select, Compress, Isolate; the memory taxonomy.context-optimizer [human] - trim token usage when a session drags.compact-guard [human] - preserve critical state before compaction.token-efficiency [auto] - anti-sycophancy, tool-call budgets, one-pass output.mcp-audit [human] - audit MCP servers for token overhead, redundancy, security.
Quality and review
tdd [human] - red-green-refactor loop with good-test guidance.deslop [auto] - strip AI slop and over-engineering from the branch diff; also lints SKILL.md files.smart-commit [human] - quality gates, staged review, conventional commit.llm-gate [auto] - LLM-verified checks on commits, patterns, patches.llm-council [human] - multi-LLM deliberation on a hard call.safe-mode [human] - hook-enforced guard against destructive operations.
Design and writing
design-engineering [auto] - interface craft: motion decision framework, easing, timing, springs, component feel, visual foundations.writing-guidelines [auto] - clear-writing standards for docs, UI copy, error messages, commit and PR text.
Knowledge and research
wiki-builder [human] - start and grow a persistent FTS5-indexed wiki.wiki-query [auto] - BM25 retrieval over a wiki with citations.wiki-research-loop [human] - budget-capped auto-grow of a wiki.wiki-viewer [human] - self-contained HTML view of a wiki.survey-generator [human] - structured literature survey on a topic.
Orientation, cost, lifecycle, setup
module-map [auto] - one-screen map of an unfamiliar area.bug-capture [auto] - turn a reported defect into a domain-language issue.cost-tracker [human] - session cost and budget alerts.permission-tuner [human] - generate allow/deny rules from denial patterns.wrap-up [human] - end-of-session ritual: audit, persist learnings, handoff.session-handoff [human] - structured handoff doc for the next session.file-watcher [human] - hooks that react to config/env/dep changes.auto-setup [human] - configure gates, hooks, settings for a new project.pro-workflow [auto] - the system overview; orchestration patterns and reference.skill-router [human] - this index of every skill and command.
Command-only (no matching skill)
These slash commands ship without a skill of the same name: /commit, /develop, /doctor, /handoff, /learn, /list, /parallel, /replay, /search, /skill-optimize, /wiki.
Naming the invocation mode
Every skill declares one intent. [human] skills are deliberate, side-effectful, or session rituals and carry user-invocable: true. [auto] skills earn their place in context by a description precise enough to fire on the right prompt and stay quiet otherwise. See rules/skill-conventions.mdc for the full convention and the write-operation rules for state-changing skills.
1---2name: skill-router-43description: The index of every pro-workflow skill and command, grouped by job, with when to reach for each and whether it is human-run or auto-triggered. Use when you are not sure which skill fits, want the full map, or ask "what can this do", "which skill for X", "list the workflow".4---5
6# skill-router
7
8You cannot hold 41 skills and 23 commands in your head. This is the index so you do not have to. Each entry says what it is for and how it fires: `[human]` you invoke it deliberately, `[auto]` the agent reaches for it from your prompt.
9
10Keep this honest. When a skill is added, renamed, removed, or changes how it fits a flow, update this file in the same change. A router that points at a skill that no longer exists, or omits a new one, is worse than none.
11
12## How to use it
13
14State the job in one line. Match it to a group below. If two skills look close, the `when to reach` clause is the tiebreaker. Most skills have a matching slash command of the same name, so this index covers commands too.
15
16## Self-correction and memory
17
18- `learn-rule` `[human]` - capture a correction as a durable rule loaded on every future session.
19- `replay-learnings` `[auto]` - surface past learnings relevant to the task before you start.
20- `insights` `[human]` - correction trends, heatmaps, productivity view.
21- `skill-optimizer` `[human]` - train a skill's SKILL.md against accumulated corrections.
22
23## Planning and decisions
24
25- `plan-interrogate` `[human]` - resolve every open decision before code; emits a decision ledger, a shared-language `CONTEXT.md`, and decision records.
26- `domain-modeling` `[human]` - build the project's shared vocabulary and bounded contexts up front.
27- `improve-architecture` `[human]` - audit an area and propose the smallest structural moves; plan, not rewrite.
28- `thoroughness-scoring` `[auto]` - score each decision point 1-10 so effort tracks stakes.
29- `orchestrate` `[human]` - wire commands, agents, and skills together for a multi-phase feature.
30
31## Multi-agent and parallel work
32
33- `agent-teams` `[human]` - lead plus teammates sharing one task list.
34- `batch-orchestration` `[human]` - split a large change into independent units, one agent each.
35- `parallel-worktrees` `[human]` - git worktrees for zero-dead-time parallel sessions.
36- `sprint-status` `[human]` - status across active parallel sessions.
37
38## Context and tokens
39
40- `context-engineering` `[human]` - Write, Select, Compress, Isolate; the memory taxonomy.
41- `context-optimizer` `[human]` - trim token usage when a session drags.
42- `compact-guard` `[human]` - preserve critical state before compaction.
43- `token-efficiency` `[auto]` - anti-sycophancy, tool-call budgets, one-pass output.
44- `mcp-audit` `[human]` - audit MCP servers for token overhead, redundancy, security.
45
46## Quality and review
47
48- `tdd` `[human]` - red-green-refactor loop with good-test guidance.
49- `deslop` `[auto]` - strip AI slop and over-engineering from the branch diff; also lints SKILL.md files.
50- `smart-commit` `[human]` - quality gates, staged review, conventional commit.
51- `llm-gate` `[auto]` - LLM-verified checks on commits, patterns, patches.
52- `llm-council` `[human]` - multi-LLM deliberation on a hard call.
53- `safe-mode` `[human]` - hook-enforced guard against destructive operations.
54
55## Design and writing
56
57- `design-engineering` `[auto]` - interface craft: motion decision framework, easing, timing, springs, component feel, visual foundations.
58- `writing-guidelines` `[auto]` - clear-writing standards for docs, UI copy, error messages, commit and PR text.
59
60## Knowledge and research
61
62- `wiki-builder` `[human]` - start and grow a persistent FTS5-indexed wiki.
63- `wiki-query` `[auto]` - BM25 retrieval over a wiki with citations.
64- `wiki-research-loop` `[human]` - budget-capped auto-grow of a wiki.
65- `wiki-viewer` `[human]` - self-contained HTML view of a wiki.
66- `survey-generator` `[human]` - structured literature survey on a topic.
67
68## Orientation, cost, lifecycle, setup
69
70- `module-map` `[auto]` - one-screen map of an unfamiliar area.
71- `bug-capture` `[auto]` - turn a reported defect into a domain-language issue.
72- `cost-tracker` `[human]` - session cost and budget alerts.
73- `permission-tuner` `[human]` - generate allow/deny rules from denial patterns.
74- `wrap-up` `[human]` - end-of-session ritual: audit, persist learnings, handoff.
75- `session-handoff` `[human]` - structured handoff doc for the next session.
76- `file-watcher` `[human]` - hooks that react to config/env/dep changes.
77- `auto-setup` `[human]` - configure gates, hooks, settings for a new project.
78- `pro-workflow` `[auto]` - the system overview; orchestration patterns and reference.
79- `skill-router` `[human]` - this index of every skill and command.
80
81## Command-only (no matching skill)
82
83These slash commands ship without a skill of the same name: `/commit`, `/develop`, `/doctor`, `/handoff`, `/learn`, `/list`, `/parallel`, `/replay`, `/search`, `/skill-optimize`, `/wiki`.
84
85## Naming the invocation mode
86
87Every skill declares one intent. `[human]` skills are deliberate, side-effectful, or session rituals and carry `user-invocable: true`. `[auto]` skills earn their place in context by a description precise enough to fire on the right prompt and stay quiet otherwise. See [`rules/skill-conventions.mdc`](../../rules/skill-conventions.mdc) for the full convention and the write-operation rules for state-changing skills.
majiayu000