Skip to content
Skills Library
Programming · Research

codemap

/codemap

Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.

Repository
Code-Map-QD ↗
Licence
MIT
Last repository change
09.11.2026

Assessment and security

96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content31 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.

Triggers from the description

where is Xwhere does Y happenwhat calls Zwhat breaks if I change W
Original author description

Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.

How it works

SKILL.md has no level-two headings · 19 lines, 221 words

SKILL.md preview
---
name: codemap
description: Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.
---

# codemap

Run from inside the repo (or pass `--root <repo>`). Use `python3` if `python` is not found.

```
python "${CLAUDE_PLUGIN_ROOT}/scripts/codemap.py" ask "<task in plain words> <4-8 words the code likely uses>"
python "${CLAUDE_PLUGIN_ROOT}/scripts/codemap.py" impact <file|symbol>   # importers depth 2 + tests to run
python "${CLAUDE_PLUGIN_ROOT}/scripts/codemap.py" file <path>            # outline instead of reading a big file
```

- Add 4-8 words the code probably uses: synonyms, identifier guesses, terms of art. Questions and code often use different words; this closes the gap (right function listed 91% with them, 75% without, on 110 test questions).
  Example: `ask "where are passwords hidden in logs mask redact obfuscate sensitive secret"`.
- Output: the best files, one per line, each with its best functions as `name start-end`. Pick the function whose name fits and read only those lines.
- If no listed function fits but a file looks right, run `file <path>` and read only the function whose name fits. An outline costs a few hundred tokens; the whole file often costs thousands.
- If nothing fits, grep.
- Put exact strings in quotes or write routes as-is (`/api/x/y`). They are searched verbatim and every file containing them is listed.
- Paths are relative to the repo root. The first call in a repo builds the index (seconds), later calls take well under a second.

Versions

RepositoryScoreLicence
This page · QDinvest/Code-Map-QD96MIT
jordancoin/codemap100MIT
AZidan/archflow100MIT
alvinunreal/oh-my-opencode-slim100MIT
jordancoin/codemap100MIT
ils15/copilot-global-config100MIT
azidan/codemap100MIT
ialameh/sift-coder100MIT
jellydn/my-ai-tools96MIT

Database snapshot: 13.11.2026 · package version abff094a93e5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100repomap
    Fast, dependency-free code index for any repository. Use it BEFORE grep, glob or reading whole files whenever you need to understand an unfamiliar repo, locate where a function, class or method is defined, see a file's structure, find who calls or imports something, or decide…
  • 100codemap-export
    Use to export the codemap as machine-readable JSON for downstream tooling. Same data as /codemap, different format. "Export the codemap", "give me the codemap as JSON".
  • 90rc-codemap
    Builds and refreshes per-directory codemap.md as a cheap structure map. Use before exploring a large repo. Do not use to trace one bug.
  • 100config-setup
    Set up or tune .codemap/config.json so Codemap focuses on code-relevant parts of the repo. Use when config is missing, boilerplate, noisy, or mismatched to the stack.
  • 90glia-find
    Find where a feature, symbol or concept lives in a codebase, as ranked nodes with path:line, then read their source. Use for "where is X", "find the code that handles Y", "which files is this task about", or to work out which files matter before reading any.
  • 100codemap-refresh
    Use when code has changed since codemap files were generated and the user wants them brought up to date: "refresh", "update the diagrams", "docs are stale". Detects which docs/codemap files are outdated and regenerates only those, preserving manual edits.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.