SkillsAdd

oaustegard/claude-skills

mapping-codebases

DEPRECATED — superseded by tree-sitting.

First seen Jan 21, 2026

Installation

$ npx skills add oaustegard/claude-skills --skill mapping-codebases
View on skills.sh ↗ GitHub repository ↗

Summary

  • DEPRECATED — superseded by tree-sitting.
  • This skill generated persistent _MAP.md files; tree-sitting does the same AST extraction at runtime (~700ms for 250 files) with no artifact to write, commit, or keep in sync.
  • Use tree-sitting for "map this codebase", "explore repo", "understand structure", or any code navigation task.
  • The final working version is archived at release mapping-codebases-v0.8.0.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

documenting-legacy-codebases Similar name
riekelt/technical-writer

Use when documenting an existing codebase whose documentation is missing, stale, or untrusted -…

5.2K installs

Also in this package

Other skills from oaustegard/claude-skills · top by installs.

npx skills add oaustegard/claude-skills
developing-preact 157 reviewing-ai-papers 111 asking-questions 97 exploring-codebases 85 image-to-svg 84 fetching-blocked-urls 67 accessing-github-repos 65 exploring-data 60 charting-vega-lite 59 extracting-keywords 57

Browse all from oaustegard/claude-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 147
Default branch main
Open issues 18
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.9.0
More metadata
version
0.9.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,088 B
  • docs SUMMARY.md 428 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 96 installs

SKILL.md

Mapping Codebases (deprecated)

Use [tree-sitting](../tree-sitting/SKILL.md) instead.

Why

This skill wrote _MAP.md files to disk — a persisted symbol inventory per directory, generated once and read many times. That tradeoff made sense when scanning was expensive. It isn't: tree-sitting parses a 250-file repo in about 700ms and answers queries against the in-memory AST in under a millisecond.

A persisted map costs what a runtime scan does not — it goes stale, it needs regenerating, it gets committed, and it must be excluded from every other tool that walks the tree. Nothing was gained for that.

Replacement commands

TREESIT=/mnt/skills/user/tree-sitting/scripts/treesit.py

# Was: codemap.py /path/to/repo          → root orientation
python3 $TREESIT /path/to/repo

# Was: reading every _MAP.md in the tree → full inventory
python3 $TREESIT /path/to/repo --depth=-1 --detail=sparse

# Was: grepping _MAP.md for a symbol     → direct lookup
python3 $TREESIT /path/to/repo --no-tree 'find:parse_input'

The archived version

The last working release is mapping-codebases-v0.8.0 (2026-03-31). It carries scripts/codemap.py and the eleven bundled parsers/*.so grammars. The release is the snapshot; nothing in this directory reproduces it.

Note that v0.8.0 ships a latent bug: codemap.py:1216 calls an unimported get_parser() inside a try swallowed by a bare except Exception, so HTML inline-JavaScript symbol extraction silently returned nothing. It will not be fixed.