Skip to content

Commit 8fea4d5

Browse files
Add Querying from Claude Code section introducing the devkg-sparql skill
1 parent 1c861c0 commit 8fea4d5

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,30 @@ PYTHONUNBUFFERED=1 python -m pipeline.link_entities \
252252
python -m pipeline.load_fuseki output/**/*.ttl --auth admin:admin
253253
```
254254

255+
### Querying from Claude Code
256+
257+
Once Fuseki has data, you don't need to write SPARQL by hand. session-graph ships with a **Claude Code skill** (`devkg-sparql`) that translates natural language questions into SPARQL queries, runs them against Fuseki, and returns formatted results.
258+
259+
The skill is automatically available when you work inside the session-graph repo. From any project, you can invoke it with `/devkg-sparql`:
260+
261+
```
262+
You: /devkg-sparql What technologies have I used the most?
263+
Claude: [runs SPARQL hub detection query → returns top 20 entities by degree]
264+
265+
You: /devkg-sparql How does FastAPI relate to Pydantic?
266+
Claude: FastAPI --uses--> Pydantic (source: session abc123, Jan 15)
267+
268+
You: /devkg-sparql What sessions discussed authentication?
269+
Claude: [returns 3 sessions across Claude Code + DeepSeek with dates and source files]
270+
271+
You: /devkg-sparql What do I know about Kubernetes?
272+
Claude: [runs entity lookup, finds 12 relationships + Wikidata link to Q22661306]
273+
```
274+
275+
The skill includes 14 local query templates (entity lookup, path discovery, hub detection, cross-session overlap, etc.) and 6 Wikidata traversal templates for enriching local entities with external knowledge. It falls back to grep-based session search if Fuseki is unreachable.
276+
277+
To use it from other projects, add the skill path to your Claude Code settings or symlink `.claude/skills/devkg-sparql/` into your project.
278+
255279
## Why RDF/SPARQL?
256280

257281
Most developer tools reach for Neo4j, vector databases, or JSON files. Here is why session-graph uses RDF and SPARQL instead.

0 commit comments

Comments
 (0)