skills-map

Skills Map — the router for lich-skills

Most skills help you do the work. This one helps you pick which skill does the work.

A skill collection has a discovery problem: the skills only fire if the agent remembers they exist and reaches for the right one at the right moment. Left to chance, the agent forgets go-no-go and starts building, or hand-rolls a debug crawl instead of running debug-hypothesis. skills-map is the index + decision tree that closes that gap.

It does three things:

1. Identify the phase of work the current task is in.
2. Route to the matching skill via the decision tree.
3. Sequence — most real work chains several skills; this gives the order.

When to Use

• At the start of any non-trivial task, before picking up tools.
• Whenever you catch yourself thinking "is there a skill for this?"
• When a task spans multiple phases and you need the ordering.
• On /skills-map, "which skill", "what can you do", "list my skills".

When NOT to Use

• The task is a one-line answer or a trivial edit — just do it.
• You already know exactly which skill applies — invoke it directly.
• You are mid-skill — finish it; don't re-route every step.

The Map (by phase of work)

   DECIDE        SPEC / PLAN          BUILD          DEBUG         FAN-OUT
 ┌────────┐   ┌──────────────┐   ┌────────────┐  ┌────────────┐ ┌──────────────┐
 │go-no-go│──▶│spec-driven-  │──▶│build-until-│─▶│debug-      │ │subagent-     │
 │ Stage 0│   │dev / -v2     │   │pass        │  │hypothesis  │ │brief         │
 │ gate   │   │ Spec→…→Ship  │   │ red→green  │  │ O→H→E→C    │ │ ≤200w/agent  │
 └────────┘   └──────────────┘   └────────────┘  └────────────┘ └──────────────┘

   RESEARCH                       MEDIA            ANALYZE
 ┌──────────────┬──────────────┐ ┌────────────┐ ┌──────────────┐
 │tavily-search │wiki-aggregate│ │nano-banana │ │google-       │
 │ web fetch    │ N notes→pack │ │ text→image │ │analytics     │
 └──────────────┴──────────────┘ └────────────┘ └──────────────┘

   DESIGN
 ┌──────────────┐
 │frontend-     │
 │design        │
 └──────────────┘