Agent-Skills.md

Agent Skills: Codebase Symbol Map Generator

Generate semantic codebase symbol map for precise code navigation. Use when starting work on unfamiliar codebase, before refactoring, or when you need to understand where classes/functions/interfaces are defined instead of using rg text-matching.

UncategorizedID: htlin222/dotfiles/map

Repository

htlin222/dotfiles
htlin222License: MIT
764

Install this agent skill to your local

pnpm dlx add-skill https://github.com/htlin222/dotfiles/tree/HEAD/claude.symlink/skills/map

Skill Files

Browse the full folder contents for map.

Download Skill

Loading file tree…

claude.symlink/skills/map/SKILL.md

Skill Metadata

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:

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

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