# Map

> Generate semantic codebase symbol map. Use when navigating unfamiliar code or before refactoring. Use when this capability is needed.

- Skill: `tomevault-io/map` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/map/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/map

---


# 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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/htlin222) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->