Explore Codebase with Graph
tirth8205/code-review-graph
Navigates a codebase through the code-review-graph MCP tools: architecture overview, symbol search, caller and callee tracing, flows and oversized functions.
A skill your agent uses for graph-first AI coding sessions and repository analysis: session initialization, architecture maps, dependency or call-graph tracing, symbol and repository search…
Install Compass
$ npx skills add crabbuild/compass --skill compass -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install crabbuild/compass compass --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/crabbuild/compass.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/compass-cli/assets/compass-skill .claude/skills/compass && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "compass" agent skill from https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skill into .claude/skills/compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compass", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add crabbuild/compass --skill compass -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install crabbuild/compass compass --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/crabbuild/compass.git skills-src && mkdir -p .agents/skills && cp -r skills-src/crates/compass-cli/assets/compass-skill .agents/skills/compass && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "compass" agent skill from https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skill into .agents/skills/compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compass", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add crabbuild/compass --skill compass -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install crabbuild/compass compass --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/crabbuild/compass.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/crates/compass-cli/assets/compass-skill .cursor/skills/compass && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "compass" agent skill from https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skill into .cursor/skills/compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compass", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/crabbuild/compass.git --path crates/compass-cli/assets/compass-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add crabbuild/compass --skill compass -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install crabbuild/compass compass --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/crabbuild/compass.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/crates/compass-cli/assets/compass-skill .gemini/skills/compass && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "compass" agent skill from https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skill into .gemini/skills/compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compass", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install crabbuild/compass compassInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add crabbuild/compass --skill compass -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/crabbuild/compass.git skills-src && mkdir -p .github/skills && cp -r skills-src/crates/compass-cli/assets/compass-skill .github/skills/compass && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "compass" agent skill from https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skill into .github/skills/compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compass", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add crabbuild/compass --skill compass -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install crabbuild/compass compass --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/crabbuild/compass.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/crates/compass-cli/assets/compass-skill .opencode/skills/compass && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "compass" agent skill from https://github.com/crabbuild/compass/tree/main/crates/compass-cli/assets/compass-skill into .opencode/skills/compass/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "compass", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
compass- GitHub stars
- 168
- Token cost
- ~5k tokens
- SKILL.md length
- 2,582 words
- Files
- 19 (incl. references)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
A skill your agent uses for graph-first AI coding sessions and repository analysis: session initialization, architecture maps, dependency or call-graph tracing, symbol and repository search…
- Works in 6 steps: Treat an explicit user command as… → If no path is supplied for a build or… → Run compass --help before inventing… → …
- Graph-first AI coding sessions and repository analysis: session initialization
- SKILL.md covers Invocation contract, Select the evidence before…, Fast path: use an existing graph and Agentic coding session, plus 7 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Compass is an agent skill from crabbuild/compass. Use for graph-first AI coding sessions and repository analysis: session initialization, architecture maps, dependency or call-graph tracing, symbol and repository search, pull-request risk review, change-impact review, historical diffs, CompassQL, graph refreshes, GROUNDED agent-authored graph enhancements, continuous overlay enrichment during coding sessions, exact overlay queries or rebases, exports, MCP serving, or project artifacts. Also use when the user invokes /compass or asks about Compass.
Its SKILL.md is about 5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `agents/openai.yaml`, `references/add-watch.md` and `references/agent-graph.md`). Compatibility notes: Requires the Compass CLI; works with Agent Skills-compatible coding agents.
It sits in Development, covering Codebase onboarding, Knowledge graphs and Pull requests. It works with Model Context Protocol. The repository describes itself as: Native, local-first knowledge graph engine for code and project artifacts—inspired by Graphify, built in Rust, and evolving beyond it.
When your agent uses it
- Graph-first AI coding sessions and repository analysis: session initialization
- Architecture maps
- Call-graph tracing
- Symbol and repository search
Example prompts
- “/compass”
Requirements
- Python 3
- Compatibility (from SKILL.md): Requires the Compass CLI; works with Agent Skills-compatible coding agents.
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Treat an explicit user command as authoritative.
- If no path is supplied for a build or refresh, use ..
- Run compass --help before inventing options or relying on a
- Use the installed native compass executable. Never substitute another
- Keep the user's requested graph, revision, output directory, and provider
- For editor or automation integrations, run `compass capabilities --format
What it can do on your machine
Read from SKILL.md and the folder at commit b204213. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Requires the Compass CLI; works with Agent Skills-compatible coding agents.
From compatibility in the SKILL.md frontmatter.
Context cost
Compass loads about 5k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 128 tokens; SKILL.md has 2,582 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,582 words (~4,984 tokens).
“Compass is the first navigation layer for codebase work. It builds and queries a local knowledge graph with native commands. Use the graph to find the smallest relevant source set, then verify important conclusions in the cited source.”
- name
- compass
- compatibility
- Requires the Compass CLI; works with Agent Skills-compatible coding agents.
- metadata.version
- 1
- metadata.product
- compass
Files
SKILL.md and 18 other files (references) in crates/compass-cli/assets/compass-skill of crabbuild/compass.
- SKILL.md
- agents/openai.yaml
- references/add-watch.md
- references/agent-graph.md
- references/command-reference.md
- references/continuous-enrichment.md
- references/exports.md
- references/extraction-spec.md
- references/github-and-merge.md
- references/history.md
- references/hooks.md
- references/labeling.md
- references/operations.md
- references/query.md
- references/reflections.md
- references/security-and-boundaries.md
- references/semantic-extraction.md
- references/serve.md
- references/update.md
Open the folder on GitHubat commit b204213
Compare with similar skills
Compass next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Compass this skillcrabbuild/compass | 168 | — | ~5k | Automated safety check: Pass | Custom licence | |
| Explore Codebase with Graphtirth8205/code-review-graph | 32k | 1 repos | ~335 | Automated safety check: Pass | MIT | |
| Slm Graphqualixar/superlocalmemory | 227 | — | ~2.7k | Automated safety check: Notes | AGPL-3.0 | |
| CodeScope Codebase Graph AnalysisQwenLM/qwen-code | 28k | 1 repos | ~9.3k | Automated safety check: Pass | Apache-2.0 | |
| Memtrace Indexsyncable-dev/memtrace-public | 486 | — | ~1.2k | Automated safety check: Pass | Custom licence | |
| Code Knowledge Graphvibeeval/vibecosystem | 531 | — | ~2.7k | Automated safety check: Notes | MIT |
Similar skills
Slm Graph
qualixar/superlocalmemory
Index and query a codebase as a structural graph — build the code graph, trace blast radius of a change, find callers/callees/inheritors, semantic code search by meaning, assemble PR review context…
CodeScope Codebase Graph Analysis
QwenLM/qwen-code
Answers questions about code structure, history, bugs and PR risk using a CodeScope knowledge graph and semantic index built from the repository.
Memtrace Index
syncable-dev/memtrace-public
Index a source-code repo into the Memtrace knowledge graph and poll the job to completion.
Code Knowledge Graph
vibeeval/vibecosystem
Codebase'i knowledge graph olarak analiz et. An agent skill from vibeeval/vibecosystem.
GitHub MCP
vibeeval/vibecosystem
GitHub MCP Server ile GitHub API erisimi. An agent skill from vibeeval/vibecosystem.
Related
Works with
Categories
Questions about Compass
What does Compass do?
A skill your agent uses for graph-first AI coding sessions and repository analysis: session initialization, architecture maps, dependency or call-graph tracing, symbol and repository search…. Compass is an agent skill from crabbuild/compass. Use for graph-first AI coding sessions and repository analysis: session initialization, architecture maps, dependency or call-graph tracing, symbol and repository search, pull-request risk review, change-impact review, historical diffs, CompassQL, graph refreshes, GROUNDED agent-authored graph enhancements, continuous overlay enrichment during coding sessions, exact overlay queries or rebases, exports, MCP serving, or project artifacts.
When should I use Compass?
Compass fits situations like: graph-first AI coding sessions and repository analysis: session initialization; architecture maps; call-graph tracing; symbol and repository search.
How do I install Compass in Claude Code?
Run `npx skills add crabbuild/compass --skill compass -a claude-code`. Or copy the skill folder (crates/compass-cli/assets/compass-skill in crabbuild/compass) into .claude/skills/compass in your project. Claude Code loads it when a task matches its description.
How do I install Compass in Codex?
Run `npx skills add crabbuild/compass --skill compass -a codex`. Or copy the skill folder (crates/compass-cli/assets/compass-skill in crabbuild/compass) into .agents/skills/compass in your project. Codex loads it when a task matches its description.
Can I use Compass in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add crabbuild/compass --skill compass -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compass, .gemini/skills/compass, .github/skills/compass and .opencode/skills/compass in your project.
What does Compass need to run?
SKILL.md names no scripts, command-line tools or credentials: Compass is instructions for the agent only. Our summary lists: Python 3. Compatibility (from SKILL.md): Requires the Compass CLI; works with Agent Skills-compatible coding agents..
Does Compass access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Compass safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Compass use?
Compass has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Compass use?
About 5k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.
What are the alternatives to Compass?
Skills that share tags, products or a category with Compass: Explore Codebase with Graph (tirth8205/code-review-graph, 32k stars), Slm Graph (qualixar/superlocalmemory, 227 stars), CodeScope Codebase Graph Analysis (QwenLM/qwen-code, 28k stars) and Memtrace Index (syncable-dev/memtrace-public, 486 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Compass?
crabbuild (a GitHub organization) maintains it in crabbuild/compass, which has 168 GitHub stars. The repository was last updated on October 3, 2026.
Source: crabbuild/compass on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.