Minimap

The mini-spec structural model in miniature — the 3-level spec→design→code layout, where artifacts live, the root spec index, and the traceability links that connect them. Load to navigate or search a mini-spec project across specs, design, and code (the model, not the maintenance process). Foundation for mini-spec.

5 stars 1 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add zot/mini-spec --skill minimap
Manual install
git clone --depth 1 https://github.com/zot/mini-spec.git /tmp/mini-spec
mkdir -p ~/.claude/skills
cp -r /tmp/mini-spec/.claude/skills/minimap ~/.claude/skills/minimap

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Minimap

How a mini-spec project is laid out, so you can find your way around it —
read it, search it, follow a clue from any layer to the others. This is the
**model**, not the process. Load `/minimap` to *navigate*; load `/mini-spec`
to *maintain* (it loads this skill underneath).

## Design docs first — not code

When understanding a feature or planning a change, start with
`design/design.md` and the relevant CRC cards/sequences **before** using
code-exploration tools (grep, symbol search, reading source). Design docs are
the project index — they show component relationships, responsibilities, and
code-file mappings more efficiently than reading code. Drop into code-level
tools only after the design docs have oriented you. And when the project keeps
a **root spec index** (below), read that *first of all* — it maps every spec
in one file, so you orient without grepping the `specs/` tree.

## The three levels

```
specs/                # Human intent — current state, in the user's own words
  migrations/         # In-flight migrations — temporary, moved on completion
    complete/         # Completed migrations, numbered in landing order
design/               # AI translation — requirements.md, crc-*, seq-*, ui-*, test-*, manifest-ui.md
docs/                 # user-manual.md, developer-guide.md
src/                  # Code with traceability comments
```

(`src/` stands in for the project's code root, whatever it's named.)
Read the full skill on GitHub

Details

Skill name
minimap
Repository
zot/mini-spec
Path
.claude/skills/minimap/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Minimap skill do?

The mini-spec structural model in miniature — the 3-level spec→design→code layout, where artifacts live, the root spec index, and the traceability links that connect them. Load to navigate or search a mini-spec project across specs, design, and code (the model, not the maintenance process). Foundation for mini-spec.

How do I install the Minimap skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add zot/mini-spec --skill minimap. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Minimap popular?

It lives in zot/mini-spec, which has 5 GitHub stars and 1 forks.

Related skills

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.