Compass Code Graph Navigator
Drives the Compass CLI's local code knowledge graph so Claude answers architecture, dependency, and change-impact questions with cited evidence.
Dev & CodingAdvanced★ 162⑂ 8AI score 9/10Last updated: Sep 28, 2026
What it does
- Bootstraps a local knowledge graph with
compass ensureat session start, then answers codebase questions through graph queries instead of broad file reads. - Routes each request to the right command:
query,ask,search,callers/callees,call-graph,impact,affected,path,explain,architecture,tree,review. - Enforces pagination discipline (follow
next=cursors tonext=none) and verification of decisive claims in real source. - Defines the Agent Graph Overlay workflow — revision pinning,
prepare→ strict batch →apply→audit, plus rebase gates when the Base Graph changes. - Classifies operation boundaries (read-only, local publication, networked/credentialed, destructive) so risky commands are never run casually.
Who it's for
- Developers navigating large or unfamiliar repositories who need architecture maps and call-graph traces.
- Teams doing PR risk review or refactor blast-radius estimation with traceable evidence.
- Existing or prospective Compass CLI users.
Examples
- "Give me an overview of this repo" → run
compass ensure, read the Agent Orientation inGRAPH_REPORT.md, thencompass architecture. - "What breaks if I change this function?" →
compass affected "<symbol>" --depth Nfor review scope, verified in source. - "How does module A reach module B?" →
compass path "A" "B"for the shortest dependency route.
· · · 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/crabbuild/compass/HEAD/crates/compass-cli/assets/compass-skill/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)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the 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 crates/compass-cli/assets/compass-skill folder from the GitHub repo crabbuild/compass into my ~/.claude/skills/compass/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/crabbuild/compass /tmp/compass && mkdir -p ~/.claude/skills && cp -r /tmp/compass/crates/compass-cli/assets/compass-skill ~/.claude/skills/compass⚠ This is a third-party skill. Check the source repository before installing.
- Install the Compass CLI first and confirm
compass --helpworks — the skill is useless without it. - Clone the repository:
git clone https://github.com/crabbuild/compass /tmp/compass - Copy the skill folder:
mkdir -p ~/.claude/skills && cp -r /tmp/compass/crates/compass-cli/assets/compass-skill ~/.claude/skills/compass - Verify the bundled
references/directory came along with it. - Restart Claude Code, open a project directory, and run
/compass --helpto confirm the skill is registered. - For a new repo, run
compass initthencompass update .; optionally keepcompass watch .running in a second terminal.
View source on GitHub ↗License: NOASSERTION