skills.rest
eklyukin
eklyukinCOMMUNITY
Explore all skills by this author →
GitHub

neo4j-migration-skill

Migrates Neo4j driver code and Cypher queries from 4.x/5.x to 2025.x/2026.x.

Updated Jul 24, 2026
Search Tags:#migration#code refactoring#driver#graph database#neo4j#cypher#database upgrade
One-click install
npx skills add https://github.com/eklyukin/my-ai-config --skill neo4j-migration-skill-eklyukin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neo4j-migration-skill
Source: https://github.com/eklyukin/my-ai-config/tree/main/skills/neo4j-migration-skill
Command: npx skills add https://github.com/eklyukin/my-ai-config --skill neo4j-migration-skill-eklyukin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading Neo4j from 4.x/5.x to 2025.x/2026.x breaks existing code: Cypher 25 removes functions like id() and shortestPath(), and all five official drivers (Python, JavaScript, Java, .NET, Go) ship breaking API changes in v6. This Skill audits a codebase, applies the correct substitutions, and produces diff-ready fixes. ## Core Features & Use Cases - Cypher 25 Migration: Complete substitution table covering id() → elementId(), shortestPath() → SHORTEST 1 QPE patterns, PERIODIC COMMIT → CALL IN TRANSACTIONS, and CALL subquery syntax updates. - Driver Migration for Five Languages: Package renames (neo4j-driver → neo4j), removed session APIs (read_transaction → execute_read), bookmark changes, and version requirements for Python, JavaScript/Node.js, Java, .NET, and Go. - Relational-to-Graph Migration: Patterns for mapping entity tables to nodes, junction tables to relationships, and FK columns to named relationships with idempotent MERGE-based imports. - Use Case: A team upgrading from Neo4j 5.26 to 2025.06 runs the Skill to scan their Python and TypeScript services, replace deprecated driver calls, rewrite Cypher queries for Cypher 25, and validate everything with EXPLAIN and test suites. ## Quick Start Ask the assistant to migrate this project's Neo4j driver code and Cypher queries from version 5.x to Neo4j 2025.x using Cypher 25.

Frequently Asked Questions about neo4j-migration-skill

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

FAQPage Schema
How do I migrate Cypher queries from Neo4j 5 to Cypher 25?▼

Apply the substitution table: replace id(n) with elementId(n), shortestPath() with SHORTEST 1 QPE patterns, PERIODIC COMMIT with CALL IN TRANSACTIONS, and variable-length paths like [:REL*1..5] with quantified path patterns (()-[:REL]->()){1,5}. Prepend CYPHER 25 to top-level queries on Neo4j 2025.06+.

How do I upgrade the Neo4j Python driver from 5.x to 6.x?▼

Replace the neo4j-driver package with neo4j>=6.0.0 in requirements.txt, then update removed APIs: read_transaction becomes execute_read, write_transaction becomes execute_write, and last_bookmark becomes last_bookmarks. Add explicit driver cleanup with context managers since auto-close on GC was removed.

Does Neo4j driver 6.x work with older Neo4j 4.4 or 5.x servers?▼

Yes, driver 6.x is Bolt-compatible with Neo4j 4.4 LTS and 5.26 LTS servers. However, Cypher 25 syntax only works on Neo4j 2025.06 and later, so keep queries on the Cypher 5 dialect when targeting older servers.

Why does elementId() break my Neo4j code after migration?▼

elementId() returns a string like "4:abc123:0" instead of the integer that id() returned. Any code storing node IDs as integers or comparing them numerically will fail; update stored IDs and WHERE clause parameters to strings.

When should I not use this Neo4j migration skill?▼

Do not use it for writing new Cypher queries (use neo4j-cypher), database administration tasks like backup and restore (use neo4j-cli-tools-skill), or provisioning new instances (use neo4j-getting-started-skill). GDS algorithm migration is also out of scope.

Related Skills

Explore More Software Engineering Skills→
neo4j-contribneo4j-contrib
101

neo4j-migration-skill

Migrate Neo4j driver code and Cypher queries to Cypher 25 syntax.

Official
Advanced
DebuggingInTearsDebuggingInTears

neo4j-cypher-skill

Upgrade legacy Neo4j Cypher queries to modern 2025.x/2026.x syntax.

Official
Intermediate
inanimate-techinanimate-tech
91

validate-app

Validate Resident Lua apps locally with permissive stubs and exit codes.

Official
Intermediate
maplin-comaplin-co

cloudflare

Provide expert guidance and documentation for Cloudflare platform services.

Official
Advanced