Skip to content
Skills Library
Programming · Analysis

map

/map

Generate semantic codebase symbol map. Use when navigating unfamiliar code or before refactoring.

Repository
dotfiles ↗
Licence
MIT
Last repository change
10.10.2026

Assessment and security

100/ 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.
Content35 / 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
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

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

Licence

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

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/symbol_map.py

What it does and when to use it

Generate semantic codebase symbol map. Use when navigating unfamiliar code or before refactoring.

Original author description

Generate semantic codebase symbol map. Use when navigating unfamiliar code or before refactoring.

How it works

  1. When to Use
  2. Execution
  3. Output Format
  4. Usage After Generation
Original SKILL.md headings · 53 lines, 170 words
SKILL.md preview
---
name: map
description: Generate semantic codebase symbol map. Use when navigating unfamiliar code or before refactoring.
---

# Codebase Symbol Map Generator

Generate a semantic symbol map showing where all exports, classes, functions, and interfaces are defined. This eliminates guessing with `rg` by providing precise `file:line` locations.

## When to Use

- Starting work on an unfamiliar codebase
- Before large-scale refactoring
- When needing to understand code structure
- To avoid `rg` text-matching confusion (same name in comments/strings)

## Execution

Run the generator script:

```bash
python3 ~/.claude/skills/map/scripts/symbol_map.py
```

The script will:

1. Detect project language (TypeScript/JavaScript/Python/Rust/Go)
2. Extract all exported symbols with their locations
3. Generate a markdown map at `~/.claude/codebase-maps/{project}_symbols.md`

## Output Format

```markdown
## Symbol Index by Type

### Classes

| Symbol         | Location                  |
| -------------- | ------------------------- |
| `AuthProvider` | `src/auth/provider.ts:15` |

### Functions

| Symbol       | Location               |
| ------------ | ---------------------- |
| `formatDate` | `src/utils/date.ts:42` |
```

## Usage After Generation

After running `/map`, use the symbol locations directly:

- "Read `src/auth/provider.ts:15` to check AuthProvider"
- "The `formatDate` function at `src/utils/date.ts:42` needs modification"

No more grepping and guessing.
Files in this package (2)
  • SKILL.md 1 KB
  • scripts/symbol_map.py 11 KB

Versions

RepositoryScoreLicence
This page · htlin222/dotfiles100MIT
milansolutionsai-ops/claude-code-map-skill100MIT
acaprino/alfio-claude-plugins100MIT
shenxingy/clade100MIT
DaBaoAgent/Auto-Video100MIT
bgmacris/quimera-ai100MIT
fabiozagaria/spring-security-advisor100MIT
roma8ok/getmapstack100MIT
smg-project/smg-dev-guide100Apache-2.0

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 440bd7f85b49 (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

  • 100map-codebase
    Create a self-maintaining codebase map in .claude/.codebase-info/. Use to map, document, analyze, or onboard a codebase, including a new project.
  • 90repomap
    Generate and query a compact, cached codebase map (~2-4k tokens) before reading files. Use when starting work in an unfamiliar repo, before broad exploration or search, and before refactoring or modifying shared modules.
  • 100code-map
    Build or query a code-only symbol and call-graph map of the current project, via LSP. Use when exploring an unfamiliar codebase, locating a symbol's definition, tracing what calls or is called by a function, assessing the blast radius of a proposed change, or navigating code…
  • 100code-map
    Generate and maintain a navigable structure map of the codebase: annotated directory tree, per-file purposes, and top-level symbols. Use when the user asks for a code map, repository map, project structure, or needs to find where something lives.
  • 100update-codebase-map
    Refresh an existing .claude/.codebase-info/ map after code changes. Use for stale codebase or architecture docs; use map-codebase to create one.
  • 95code-atlas
    Build a compact, queryable map of a codebase before reading files. Use when exploring an unfamiliar repository, locating a symbol, estimating blast radius, finding affected tests, packing context under a token budget, or generating an architecture map/diagram. Works with any…

Feedback and reports

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