compasslisted
Install: claude install-skill crabbuild/compass
# 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.
6. For editor or automation integrations, run `compass capabilities --format
json` before assuming a machine contract. Reject an unknown contract major
instead of guessing a compatible shape.
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 `.`.
- Current graph: explicit `--graph`, otherwise `compass-out/graph.json`.
- Historical