paper-cluster

name	paper-cluster
description	Build, query, and visualize literature relationship clusters using Kuzu and Cypher.
requires	{"bins":["/root/openclaw-dev/envs/academic-embed/bin/python"]}

Paper Cluster

Use this skill when the user wants to build or inspect a literature graph, run Cypher over paper and entity relationships, or render a paper cluster visualization.

Capabilities

• ingest normalized paper JSON into Kuzu
• query the paper graph with Cypher
• render cluster graphs to PNG

Data Rules

• All runtime data for this skill must stay under /root/openclaw-dev/data/
• Kuzu database path: /root/openclaw-dev/data/kuzu/academic_graph
• Visualization output path: /root/openclaw-dev/data/visualizations/
• Query audit path: /root/openclaw-dev/data/queries/last_query.json

Commands

Ingest one normalized paper:

/root/openclaw-dev/envs/academic-embed/bin/python /root/openclaw-dev/workspace/scripts/graph_engine.py ingest /root/openclaw-dev/workspace/data/normalized/2312.10793v3.json

Run a Cypher query directly:

/root/openclaw-dev/envs/academic-embed/bin/python /root/openclaw-dev/workspace/scripts/graph_engine.py query "MATCH (p:Paper)-[:MENTIONS]->(e:Entity) RETURN p.id AS paper_id, e.name AS entity LIMIT 10"

Render a paper cluster visualization:

/root/openclaw-dev/envs/academic-embed/bin/python /root/openclaw-dev/workspace/scripts/graph_engine.py visualize "MATCH (p:Paper)-[:MENTIONS]->(e:Entity) RETURN p.id AS source, 'Paper' AS source_label, 'MENTIONS' AS rel_type, e.name AS target, 'Entity' AS target_label LIMIT 50" --output-name paper-cluster-demo.png

Notes

• Entity nodes are rendered in blue.
• Paper nodes are rendered in red.
• query expects a Cypher string that has already been produced from user intent.
• visualize expects query output columns named: source, source_label, rel_type, target, target_label.