Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Python ai-agentsantigravityastclaude-codecode-analysiscode-searchcodexcursordeveloper-toolsgeminigraphifygraphragknowledge-graphleidenllmmcpopenclawragskillstree-sitter
fix: 5 skill gaps - graphml usage, manifest timing, graph existence checks, no-viz clarity
Safi0061b36c2923
diff --git a/graphify/skill.md b/graphify/skill.mdindex 25441d6c1..61ca3a5ba 100644--- a/graphify/skill.md+++ b/graphify/skill.md@@ -19,6 +19,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti/graphify <path> --no-viz # skip visualization, just report + JSON/graphify <path> --html # also export graph.html (interactive vis.js, browser-based)/graphify <path> --svg # also export graph.svg (embeds in Notion, GitHub)+/graphify <path> --graphml # export graph.graphml (Gephi, yEd)/graphify <path> --neo4j # generate graphify-out/cypher.txt for Neo4j/graphify <path> --neo4j-push bolt://localhost:7687 # push directly to Neo4j/graphify <path> --mcp # start MCP stdio server for agent access@@ -384,7 +385,7 @@ Replace INPUT_PATH with the actual path.### Step 6 - Generate Obsidian vault (default) + optional HTML-**Always generate the Obsidian vault** - it is the primary visualization. Skip only if `--no-viz`.+**Always generate the Obsidian vault and HTML** - they are the primary visualizations. Skip both if `--no-viz` (report + JSON only).```bashpython3 -c "@@ -681,11 +682,6 @@ G_new = build_from_json(new_extraction)# Merge: new nodes/edges into existing graphG_existing.update(G_new)print(f'Merged: {G_existing.number_of_nodes()} nodes, {G_existing.number_of_edges()} edges')--# Save manifest so next --update knows what changed-from graphify.detect import save_manifest, detect-detect_result = json.loads(Path('.graphify_detect.json').read_text())-save_manifest(detect_result['files'])"```@@ -779,6 +775,17 @@ Two traversal modes - choose based on the question:| BFS (default) | _(none)_ | "What is X connected to?" - broad context, nearest neighbors first || DFS | `--dfs` | "How does X reach Y?" - trace a specific chain or dependency path |+First check the graph exists:+```bash+python3 -c "+from pathlib import Path+if not Path('graphify-out/graph.json').exists():+ print('ERROR: No graph found. Run /graphify <path> first to build the graph.')+ raise SystemExit(1)+"+```+If it fails, stop and tell the user to run `/graphify <path>` first.+Load `graphify-out/graph.json`, then:1. Find the 1-3 nodes whose label best matches key terms in the question.@@ -901,6 +908,17 @@ Replace `QUESTION` with the question, `ANSWER` with your full answer text, `SOURFind the shortest path between two named concepts in the graph.+First check the graph exists:+```bash+python3 -c "+from pathlib import Path+if not Path('graphify-out/graph.json').exists():+ print('ERROR: No graph found. Run /graphify <path> first to build the graph.')+ raise SystemExit(1)+"+```+If it fails, stop and tell the user to run `/graphify <path>` first.+```bashpython3 -c "import json, sys@@ -974,6 +992,17 @@ print('Path result saved to graphify-out/memory/')Give a plain-language explanation of a single node - everything connected to it.+First check the graph exists:+```bash+python3 -c "+from pathlib import Path+if not Path('graphify-out/graph.json').exists():+ print('ERROR: No graph found. Run /graphify <path> first to build the graph.')+ raise SystemExit(1)+"+```+If it fails, stop and tell the user to run `/graphify <path>` first.+```bashpython3 -c "import json, sysdiff --git a/skills/graphify/skill.md b/skills/graphify/skill.mdindex 25441d6c1..61ca3a5ba 100644--- a/skills/graphify/skill.md+++ b/skills/graphify/skill.md@@ -19,6 +19,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti/graphify <path> --no-viz # skip visualization, just report + JSON/graphify <path> --html # also export graph.html (interactive vis.js, browser-based)/graphify <path> --svg # also export graph.svg (embeds in Notion, GitHub)+/graphify <path> --graphml # export graph.graphml (Gephi, yEd)/graphify <path> --neo4j # generate graphify-out/cypher.txt for Neo4j/graphify <path> --neo4j-push bolt://localhost:7687 # push directly to Neo4j/graphify <path> --mcp # start MCP stdio server for agent access@@ -384,7 +385,7 @@ Replace INPUT_PATH with the actual path.### Step 6 - Generate Obsidian vault (default) + optional HTML-**Always generate the Obsidian vault** - it is the primary visualization. Skip only if `--no-viz`.+**Always generate the Obsidian vault and HTML** - they are the primary visualizations. Skip both if `--no-viz` (report + JSON only).```bashpython3 -c "@@ -681,11 +682,6 @@ G_new = build_from_json(new_extraction)# Merge: new nodes/edges into existing graphG_existing.update(G_new)print(f'Merged: {G_existing.number_of_nodes()} nodes, {G_existing.number_of_edges()} edges')--# Save manifest so next --update knows what changed-from graphify.detect import save_manifest, detect-detect_result = json.loads(Path('.graphify_detect.json').read_text())-save_manifest(detect_result['files'])"```@@ -779,6 +775,17 @@ Two traversal modes - choose based on the question:| BFS (default) | _(none)_ | "What is X connected to?" - broad context, nearest neighbors first || DFS | `--dfs` | "How does X reach Y?" - trace a specific chain or dependency path |+First check the graph exists:+```bash+python3 -c "+from pathlib import Path+if not Path('graphify-out/graph.json').exists():+ print('ERROR: No graph found. Run /graphify <path> first to build the graph.')+ raise SystemExit(1)+"+```+If it fails, stop and tell the user to run `/graphify <path>` first.+Load `graphify-out/graph.json`, then:1. Find the 1-3 nodes whose label best matches key terms in the question.@@ -901,6 +908,17 @@ Replace `QUESTION` with the question, `ANSWER` with your full answer text, `SOURFind the shortest path between two named concepts in the graph.+First check the graph exists:+```bash+python3 -c "+from pathlib import Path+if not Path('graphify-out/graph.json').exists():+ print('ERROR: No graph found. Run /graphify <path> first to build the graph.')+ raise SystemExit(1)+"+```+If it fails, stop and tell the user to run `/graphify <path>` first.+```bashpython3 -c "import json, sys@@ -974,6 +992,17 @@ print('Path result saved to graphify-out/memory/')Give a plain-language explanation of a single node - everything connected to it.+First check the graph exists:+```bash+python3 -c "+from pathlib import Path+if not Path('graphify-out/graph.json').exists():+ print('ERROR: No graph found. Run /graphify <path> first to build the graph.')+ raise SystemExit(1)+"+```+If it fails, stop and tell the user to run `/graphify <path>` first.+```bashpython3 -c "import json, sys