neo4j-cypher-guide — Claude Code skill: use and install
neo4j-cypher-guide guides AI agents in writing current Neo4j Cypher read queries, choosing read subqueries, and traversing graphs with modern path patterns.
no license 1 installs ★ 1,649 updated 2025-12-27
npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a claude-codeWhat neo4j-cypher-guide does
This skill guides Neo4j read-query generation with current Cypher syntax. It replaces id() with elementId(), makes aggregation grouping explicit through WITH, and uses COUNT{}, EXISTS{}, and COLLECT{} subqueries where they fit. Complex reads can be organized with CALL subqueries and explicit variable scope.
The guide covers Quantified Path Patterns for variable-length traversal, including predicates applied inside the pattern. It also recommends anchoring matches on indexed properties, bounding expansion depth, and checking plans with PROFILE. A sorted property that can contain null should be filtered before ORDER BY; otherwise the result may contain null. Reference material is split across deprecated syntax, subqueries, and QPP topics.
What it helps with
- modernize Neo4j queries that use removed syntax
- replace
id()withelementId() - structure complex reads with
CALLandCOLLECT{} - filter nullable values before sorting
- rewrite variable-length traversal with QPP
Example prompts for the agent
- Rewrite this Neo4j read query with current Cypher and replace
id(). - Build a department query with
CALL, return the three highest salaries, and collect their names withCOLLECT{}. - Refactor this one-to-five-hop traversal so node filters run inside a QPP.
How to install neo4j-cypher-guide
1Skills CLI (Vercel)
npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a claude-code2Manually: put the files in place
~/.claude/skills/neo4j-cypher-guide/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/neo4j-cypher-guide/
1Skills CLI (Vercel)
npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a codex2Manually: put the files in place
.agents/skills/neo4j-cypher-guide/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a cursor2Manually: put the files in place
.cursor/skills/neo4j-cypher-guide/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tomasonjo/blogs claude-skills/neo4j-cypher-guide/neo4j-cypher-guide2Manually: put the files in place
.github/skills/neo4j-cypher-guide/SKILL.md1Skills CLI (Vercel)
npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a gemini-cli2Platform CLI
gemini skills install https://github.com/tomasonjo/blogs --path claude-skills/neo4j-cypher-guide/neo4j-cypher-guideManually: put the files in place
.devin/skills/neo4j-cypher-guide/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about neo4j-cypher-guide
How do I install neo4j-cypher-guide in Claude Code?
Run npx skills add tomasonjo/blogs --skill neo4j-cypher-guide -a claude-code, then check ~/.claude/skills/neo4j-cypher-guide/SKILL.md.
What does neo4j-cypher-guide do?
It helps generate modern Neo4j read queries with explicit grouping, read subqueries, null-aware sorting, and Quantified Path Patterns for graph traversal.
What should replace id() in a Neo4j query?
Use elementId(). Its result is a string rather than an integer, so comparisons need to account for that type.