Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Nexus Mapper — AI Codebase Map Generator

Runs a five-phase PROBE survey of any local Git repo and produces a persistent .nexus-map/ knowledge base so any AI session can cold-start with real architectural context.

Dev & CodingAdvanced★ 163⑂ 15AI score 9/10Last updated: Mar 31, 2026

What it does

  • Combines Tree-sitter AST extraction with Git history forensics to survey a repository systematically.
  • Emits a .nexus-map/ directory: INDEX.md (cold-start router, under 2000 tokens), arch/systems.md (system boundaries + code paths), arch/dependencies.md (Mermaid dependency and sequence diagrams), arch/test_coverage.md, concepts/concept_model.json (machine-readable graph), hotspots/git_forensics.md (churn hotspots and coupled file pairs), plus raw data in raw/.
  • Enforces phase gates (PROFILE → REASON → OBJECT → BENCHMARK → EMIT) with strict evidence rules: only implemented nodes may carry a verified code_path; anything else must be planned/inferred with an explicit evidence_gap.
  • Auto-dispatches across 30+ languages by extension, with --add-extension, --add-query and --language-config for unsupported ones, plus --exclude-dirs and .gitignore filtering.
  • Safety rails: atomic writes via .tmp/, overwrite confirmation, no execution of the target repo's build/test scripts, and secrets are noted but never copied.

Who it's for

  • Developers who must get productive fast in an unfamiliar legacy or open-source repository.
  • Teams planning a large refactor who need an evidence-backed map of boundaries and blast radius.
  • Orgs that want a shared, reusable context artifact so every AI session doesn't start from zero.

Example uses

  1. "Analyze this repo and build a project knowledge base" → the full .nexus-map/ set is generated; later sessions read INDEX.md and get to work immediately.
  2. Before renaming a public function: query_graph.py --impact src/core/auth.py --git-stats raw/git_stats.json to quantify impact radius and change risk.
  3. Re-run extract_ast.py --exclude-dirs django_static,third_party/assets to drop vendored asset noise from the AST and file tree.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/Haaaiawd/Nexus-skills/HEAD/skills/nexus-mapper/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/nexus-mapper folder from the GitHub repo Haaaiawd/Nexus-skills into my ~/.claude/skills/nexus-mapper/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/Haaaiawd/Nexus-skills.git && mkdir -p ~/.claude/skills && cp -r Nexus-skills/skills/nexus-mapper ~/.claude/skills/ && pip install -r ~/.claude/skills/nexus-mapper/scripts/requirements.txt

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal in the folder where you keep tools.
  2. Clone the repo: git clone https://github.com/Haaaiawd/Nexus-skills.git
  3. Copy the skill into Claude Code's skills folder: mkdir -p ~/.claude/skills && cp -r Nexus-skills/skills/nexus-mapper ~/.claude/skills/
  4. Check Python: python --version (must be 3.10 or newer).
  5. Install dependencies: pip install -r ~/.claude/skills/nexus-mapper/scripts/requirements.txt
  6. Verify with python -c "import tree_sitter" — it should print nothing and exit cleanly.
  7. Restart Claude Code, then ask: "use nexus-mapper to build a knowledge base for <absolute repo path>".
  8. Optional: add the suggested rule to your CLAUDE.md or AGENTS.md so future sessions always read .nexus-map/INDEX.md first.
View source on GitHub ↗