compass
Use for questions about a codebase, its architecture, dependencies, history, change impact, or project artifacts—especially when compass-out exists or the user invokes /compass.
npx skills add crabbuild/compass --skill compass-skill --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Compass 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. ## Invocation contract If the user invokes `/compass --help` or `/compass -h` without another request, run `compass --help`, return its current command summary, and stop. Otherwise: 1. Treat an explicit user command as authoritative. 2. If no path is supplied for a build or refresh, use `.`. 3. Run `compass <command> --help` before inventing options or relying on a remembered flag. 4. Use the installed native `compass` executable. Never substitute another product, a Python module, or an unsupported command. 5. Keep the user's requested graph, revision, output directory, and provider explicit throughout the workflow. Do not silently fall back to another one. If `compass` is unavailable, report that fact and provide the exact command that would have been run. Do not emulate a successful Compass result with broad source searches. ## Select the evidence before acting Resolve these inputs first: - Source root: the supplied path, otherwise `.`. -
- Invocation contract
- Select the evidence before acting
- Fast path: use an existing graph
- Build or refresh
- Command routing
- Answering workflow
- On-demand references
- Completion rules
What does the compass skill do?
Use for questions about a codebase, its architecture, dependencies, history, change impact, or project artifacts—especially when compass-out exists or the user invokes /compass.
How do I install it?
Run `npx skills add crabbuild/compass --skill compass-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From crabbuild/compass, a repository with 90 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.