Agent skill

Skills Map

by LichAmnesia in LichAmnesia/lich-skills

Use at the START of any task, or whenever you are unsure which lich-skill applies.

MITAuto-check passed

Install Skills Map

skills CLI

$ npx skills add LichAmnesia/lich-skills --skill skills-map -a claude-code

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

GitHub CLI

$ gh skill install LichAmnesia/lich-skills skills-map --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/LichAmnesia/lich-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skills-map .claude/skills/skills-map && 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/

Paste into Claude Code

Install the "skills-map" agent skill from https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map into .claude/skills/skills-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skills-map", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add LichAmnesia/lich-skills --skill skills-map -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install LichAmnesia/lich-skills skills-map --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LichAmnesia/lich-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/skills-map .agents/skills/skills-map && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "skills-map" agent skill from https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map into .agents/skills/skills-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skills-map", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LichAmnesia/lich-skills --skill skills-map -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install LichAmnesia/lich-skills skills-map --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LichAmnesia/lich-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/skills-map .cursor/skills/skills-map && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "skills-map" agent skill from https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map into .cursor/skills/skills-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skills-map", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/LichAmnesia/lich-skills.git --path skills/skills-map

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add LichAmnesia/lich-skills --skill skills-map -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install LichAmnesia/lich-skills skills-map --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LichAmnesia/lich-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/skills-map .gemini/skills/skills-map && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "skills-map" agent skill from https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map into .gemini/skills/skills-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skills-map", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install LichAmnesia/lich-skills skills-map

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add LichAmnesia/lich-skills --skill skills-map -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/LichAmnesia/lich-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/skills-map .github/skills/skills-map && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "skills-map" agent skill from https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map into .github/skills/skills-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skills-map", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LichAmnesia/lich-skills --skill skills-map -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install LichAmnesia/lich-skills skills-map --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LichAmnesia/lich-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/skills-map .opencode/skills/skills-map && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "skills-map" agent skill from https://github.com/LichAmnesia/lich-skills/tree/main/skills/skills-map into .opencode/skills/skills-map/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skills-map", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: skills-map
GitHub stars: 234
Token cost: ~1.9k tokens
SKILL.md length: 586 words
Files: 2
Skills in repo: 11
Repo updated: Jun 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Use at the START of any task, or whenever you are unsure which lich-skill applies.

Works in 3 steps: Identify the phase of work the current… → Route to the matching skill via the… → Sequence — most real work chains several…
SKILL.md covers When to Use, When NOT to Use, The Map (by phase of work) and Decision Tree, plus 5 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skills Map is an agent skill from LichAmnesia/lich-skills. Use at the START of any task, or whenever you are unsure which lich-skill applies. The router for this collection — it maps every lich-skill to the phase of work it belongs to (Decide → Spec → Plan → Build → Debug → Fan-out → Research → Media → Analyze) and walks a decision tree to pick the right one. Prevents the two failure modes of a skill collection: forgetting a skill exists, and reaching for the wrong skill at the wrong phase. Triggered by "/skills-map", "which skill should I use", "what skills do I have"…

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

The licence is MIT.

Example prompts

“/skills-map”
“which skill should I use”
“what skills do I have”
“/skills-map”

Workflow steps

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

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

What it can do on your machine

Read from SKILL.md and the folder at commit ebbc355. 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
No scripts in the folder and no shell commands in SKILL.md.
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

Skills Map loads about 1.9k tokens when it runs. Until then it costs about 142 tokens; SKILL.md has 586 words of instructions outside code blocks.

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

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 LichAmnesia/lich-skills at commit ebbc355, republished under its MIT licence (© LichAmnesia). 586 words, ~1,859 tokens.

Download SKILL.mdSave it as .claude/skills/skills-map/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: skills-map
description: Use at the START of any task, or whenever you are unsure which lich-skill applies. The router for this collection — it maps every lich-skill to the phase of work it belongs to (Decide → Spec → Plan → Build → Debug → Fan-out → Research → Media → Analyze) and walks a decision tree to pick the right one. Prevents the two failure modes of a skill collection: forgetting a skill exists, and reaching for the wrong skill at the wrong phase. Triggered by "/skills-map", "which skill should I use", "what skills do I have", or any moment of skill-selection doubt.

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:

Identify the phase of work the current task is in.
Route to the matching skill via the decision tree.
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        │
 └──────────────┘

Decision Tree

Walk top to bottom; take the first branch that matches.

START
│
├─ About to start a NEW project / repo / contract?  ───────────▶  go-no-go   (Stage 0 — NO-GO is the default)
│
├─ Feature/refactor touching >1 file, needs a spec first?
│     ├─ hours–days, many files, multiple slices  ─────────────▶  spec-driven-dev-v2
│     └─ single feature, normal scope             ─────────────▶  spec-driven-dev
│
├─ A build / typecheck / lint / test is RED and you want green ─▶  build-until-pass
│
├─ Something is broken and you don't know WHY  ────────────────▶  debug-hypothesis
│
├─ About to spawn subagents / Task / Agent fan-out  ──────────▶  subagent-brief  (compress FIRST)
│
├─ Building a UI / page / component  ──────────────────────────▶  frontend-design
│
├─ Need facts / docs / citations from the web  ───────────────▶  tavily-search
│
├─ Have N≥3 raw research notes to lift into one pack  ─────────▶  wiki-aggregate
│
├─ Need an image generated or edited  ─────────────────────────▶  nano-banana
│
├─ Question about site traffic / GA4 / SEO  ──────────────────▶  google-analytics
│
└─ None match  ───────────────────────────────────────────────▶  no skill; proceed manually

Quick Reference

Phase	Skill	Use it when…
Decide	`go-no-go`	Before any spec/plan/code — should this project start at all? NO-GO is the default.
Spec → Ship	`spec-driven-dev`	Any non-trivial feature/refactor touching >1 file. Gated Spec→Plan→Build→Test→Review→Ship.
Long-horizon	`spec-driven-dev-v2`	Agent works hours–days across many files/slices. Project→Sprint→Task hierarchy + review loop.
Build	`build-until-pass`	A check is RED. Run → read error → smallest fix → re-run, until exit code 0 (cap 10).
Debug	`debug-hypothesis`	Bug with unknown cause. Scientific method: Observe → Hypothesize → Experiment → Conclude.
Fan-out	`subagent-brief`	Before spawning subagents. Compress each prompt to ≤200 words — no shared prefix cache.
Design	`frontend-design`	Building UI. Distinctive, production-grade interfaces that avoid generic AI-slop aesthetics.
Research	`tavily-search`	Real-time web search + content extraction via Tavily API. Facts, docs, citations.
Research	`wiki-aggregate`	N≥3 raw notes → one structured pack with cross-source claims + `path:line` provenance.
Media	`nano-banana`	Text-to-image or image edit via Nano Banana 2. 512 / 1K / 2K / 4K.
Analyze	`google-analytics`	GA4 traffic analysis + out-of-the-box SEO daily report for one property.

Show full SKILL.md (215 more words)Show less

Typical Sequences

Real work chains skills. The common pipelines:

New project          go-no-go → spec-driven-dev → build-until-pass → (bug?) debug-hypothesis
Long migration       go-no-go → spec-driven-dev-v2 → subagent-brief (per reviewer) → build-until-pass
Build a landing page spec-driven-dev → frontend-design → nano-banana (hero art) → build-until-pass
Research → report    tavily-search → wiki-aggregate
Ship + measure       …build-until-pass → google-analytics (post-launch SEO/traffic)

Skill Rules

Route before you reach. When in doubt, run the decision tree before grabbing a tool — picking the wrong skill costs more than the 5 seconds of routing.
go-no-go gates everything. If the task is "start X", that branch wins over every build/spec branch below it. Do not skip Stage 0 because you're eager to build.
One phase, one skill. Don't stack skills for the same phase. Finish the active skill before re-routing.

Anti-Rationalization

Excuse	Reality
"I know the codebase, I'll just start coding."	That's the `go-no-go` / `spec-driven-dev` skip that produces the wrong thing fast. Route first.
"I'll debug it by reading around."	Unstructured crawling is the failure `debug-hypothesis` exists to prevent. Run the loop.
"I'll just spawn 10 subagents with full context."	One fan-out can burn a day of quota. `subagent-brief` first — always.
"No skill fits, I'll improvise."	Re-read the tree once. If it genuinely doesn't match, then proceed manually — and that's fine.

Maintenance

This map is hand-curated. When a skill is added to or removed from this collection, update the phase map, decision tree, and quick-reference table here in the same change. A router that lists skills that don't exist — or omits ones that do — is worse than no router.

Files

SKILL.md and 1 other file in skills/skills-map of LichAmnesia/lich-skills.

SKILL.md
README.md

Open the folder on GitHubat commit ebbc355

Compare with similar skills

Skills Map 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.

Skills Map compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Skills Map this skillLichAmnesia/lich-skills	234	—	~1.9k	Automated safety check: Pass	MIT	4 mo ago
Oh My Claude Code Skill MapYeachan-Heo/oh-my-claudecode	40k	—	~746	Automated safety check: Pass	MIT	today
MapSethGammon/Citadel	922	—	~1.8k	Automated safety check: Pass	MIT	6 days ago
Mapcountbot-ai/CountBot	782	—	~445	Automated safety check: Pass	MIT	4 days ago
Mapzeuikli/claude-code-workspace	156	1 repos	~449	Automated safety check: Pass	None	2 days ago
Token Mapnexu-io/open-design	100k	—	~1.4k	Automated safety check: Pass	Apache-2.0	today

Similar skills

Oh My Claude Code Skill Map
Yeachan-Heo/oh-my-claudecode
Routes a request to the right oh-my-claudecode skill by listing which skill owns each job, in delivery-loop order, without running anything itself.
40k GitHub stars~746 tokensUpdated today
Agent WorkflowsAuto-check passed
Map
SethGammon/Citadel
Structural codebase index generator. An agent skill from SethGammon/Citadel.
922 GitHub stars~1.8k tokensUpdated 6 days ago
Agent WorkflowsAuto-check passed
Map
countbot-ai/CountBot
高德地图路线规划与 POI 搜索。支持驾车、步行、骑行、公交路线规划，以及景点、餐厅搜索。当用户询问路线、行程规划、景点推荐、餐厅推荐时使用。
782 GitHub stars~445 tokensUpdated 4 days ago
Auto-check passed
Map
zeuikli/claude-code-workspace
產出 codebase 語意符號地圖（classes、functions、interfaces、types 的精確 file:line 位置）。適合在大型重構前或接手陌生 codebase 時使用。
156 GitHub starsUsed in 1 repo~449 tokens
Auto-check passed
Token Map
nexu-io/open-design
Map an extracted Figma / source-code token bag onto the active OD design system, producing a deterministic mapping the generate stage can consume.
100k GitHub stars~1.4k tokensUpdated today
Frontend & DesignAuto-check passed
Maps Geography
asgeirtj/system_prompts_leaks
Accurate maps from real geo data — use for any map, or whenever geography would make a good graphic for a deliverable
69k GitHub stars~717 tokensUpdated today
Auto-check passed

Questions about Skills Map

What does Skills Map do?

Use at the START of any task, or whenever you are unsure which lich-skill applies. Skills Map is an agent skill from LichAmnesia/lich-skills. Use at the START of any task, or whenever you are unsure which lich-skill applies.

How do I install Skills Map in Claude Code?

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

How do I install Skills Map in Codex?

Run `npx skills add LichAmnesia/lich-skills --skill skills-map -a codex`. Or copy the skill folder (skills/skills-map in LichAmnesia/lich-skills) into .agents/skills/skills-map in your project. Codex loads it when a task matches its description.

Can I use Skills Map 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 LichAmnesia/lich-skills --skill skills-map -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skills-map, .gemini/skills/skills-map, .github/skills/skills-map and .opencode/skills/skills-map in your project.

What does Skills Map need to run?

SKILL.md names no scripts, command-line tools or credentials: Skills Map is instructions for the agent only.

Does Skills Map 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 Skills Map 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 Skills Map use?

Skills Map is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skills Map use?

About 1.9k tokens (SKILL.md is roughly 7.4k 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 Skills Map?

Skills that share tags, products or a category with Skills Map: Oh My Claude Code Skill Map (Yeachan-Heo/oh-my-claudecode, 40k stars), Map (SethGammon/Citadel, 922 stars), Map (countbot-ai/CountBot, 782 stars) and Map (zeuikli/claude-code-workspace, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skills Map?

LichAmnesia (a GitHub user) maintains it in LichAmnesia/lich-skills, which has 234 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on June 9, 2026.

Source: LichAmnesia/lich-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Skills Map

Facts

At a glance

What it does

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Skills Map — the router for lich-skills

When to Use

When NOT to Use

The Map (by phase of work)

Decision Tree

Quick Reference

Typical Sequences

Skill Rules

Anti-Rationalization

Maintenance

Files

Compare with similar skills

Similar skills

More from LichAmnesia/lich-skills

Questions about Skills Map