crew-graph

Build and query a repository code graph with graphify, keeping graph.json fresh on commit.

2|Updated Jul 28, 2026
One-click install
npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill crew-graph-mbadali25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crew-graph
Source: https://github.com/mbadali25/useful-claude-add-ons/tree/main/plugin/crew/skills/crew-graph
Command: npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill crew-graph-mbadali25

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires graphifyy, and includes scripts (resource) components.

What problem does it solve? Understanding how a large repository is wired — what calls what, what connects to what — normally means reading hundreds of files. This Skill builds a static code graph of the repo with the graphify CLI, keeps it on the filesystem as a single greppable graph.json, and refreshes it automatically on every commit, so structural questions are answered by query instead of by manual exploration. ## Core Features & Use Cases - Graph building: Runs graphify . --no-viz --code-only to produce graph.json in graphify-out/ with no LLM API key required; docs, PDFs, and images are opt-in only. - Natural-language querying: Answers questions like "what connects the install scripts to the skills catalog?" via graphify query, plus graphify path and graphify explain for tracing routes and explaining nodes. - Commit-based freshness: Installs a Git hook and union merge driver so graph.json is rebuilt and merged on every commit, with a built_at_commit field as the single source of truth for staleness. - Codemap reconciliation: Ships scripts that merge graph-derived facts into human-written codemap notes under a KEEP/DERIVE split, reporting conflicts without overwriting human judgment. - Use case: Ask "how is the billing subsystem wired?" and get an answer from the graph, then fold the verified structure into .crew/codemap/ notes during an upgrade run. ## Quick Start Ask the assistant to build the code graph for this repository and then query what connects two subsystems you name.

Frequently Asked Questions about crew-graph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a code graph of my repository?

Run `graphify . --no-viz --code-only` from the repo root. The code-only flag skips docs and images so no LLM API key is needed, and no-viz skips the HTML output. Results land in graphify-out/graph.json.

How do I query what calls what in a codebase?

Use `graphify query` with a natural-language question, such as "what connects the install scripts to the skills catalog?". For tracing a specific route or explaining one node, use `graphify path` or `graphify explain`.

Which PyPI package installs the graphify CLI?

The package is graphifyy with a double y, installed via `uv tool install graphifyy`; it provides the `graphify` command. Other graphify-named packages on PyPI are unaffiliated and install the wrong tool silently.

Does the code graph stay up to date automatically?

Yes. `graphify hook install` adds a Git hook that rebuilds the graph on every commit plus a union merge driver for graph.json. Freshness is commit-based: it reflects the last commit, not uncommitted working-tree edits.

Can I export the code graph to Obsidian?

No. The Obsidian export was removed in 0.16.13 because fanning one dense graph into tens of thousands of vault notes made Obsidian unusably slow. Query the graph directly or write prose codemap notes instead.

Why does graphify fail with 'no LLM API key found'?

That error appears when building without --code-only on a repo containing docs, papers, or images, which require semantic extraction via an LLM. Always pass --code-only, or set the required API key env var before opting into document extraction.