skills.rest
cardox6
cardox6COMMUNITY
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 Aug 25, 2026
Search Tags:#migration#graph database#code modernization#neo4j#cypher#cypher 25#driver upgrade
One-click install
npx skills add https://github.com/cardox6/steuer-graph --skill neo4j-migration-skill-cardox6
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neo4j-migration-skill
Source: https://github.com/cardox6/steuer-graph/tree/main/.agents/skills/neo4j-migration-skill
Command: npx skills add https://github.com/cardox6/steuer-graph --skill neo4j-migration-skill-cardox6

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 renamed or removed core APIs. This Skill audits a codebase, applies the correct substitutions, and produces diff-ready fixes so the upgrade does not stall on deprecated syntax. ## Core Features & Use Cases - Cypher 25 migration: Applies a complete substitution table covering QPE path quantifiers, id() to elementId(), PERIODIC COMMIT to CALL IN TRANSACTIONS, CALL subquery syntax, and version-branched vector index queries. - Driver migration for five languages: Covers Python (neo4j-driver to neo4j package rename), JavaScript/Node.js, Java, .NET, and Go with removed-API tables, minimum version requirements, and code diffs. - Relational-to-graph migration: Classifies entity, junction, and lookup tables, maps foreign keys to relationships, and provides MERGE-based idempotent import patterns. - Use Case: A team upgrading from Neo4j 5.26 to 2026.01 scans their Python and JavaScript services, replaces read_transaction with execute_read, converts shortestPath queries to SHORTEST 1 QPE syntax, and validates every migrated query with EXPLAIN before deployment. ## Quick Start Ask the assistant to migrate this repository's Neo4j driver code and Cypher queries from version 5.x to Neo4j 2026.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?▼

Replace removed syntax using the substitution table: id(n) becomes elementId(n), shortestPath becomes SHORTEST 1 with QPE quantifiers, and PERIODIC COMMIT becomes CALL IN TRANSACTIONS. Prepend CYPHER 25 to top-level queries on Neo4j 2025.06 or later, then validate each query with EXPLAIN.

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

Replace the deprecated neo4j-driver package with neo4j>=6.0.0 in requirements.txt, which requires Python 3.10 or later. Rename session.read_transaction to session.execute_read, session.write_transaction to session.execute_write, and add explicit driver cleanup with context managers or close().

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, 4.4 support ended in November 2025, and no downgrades are supported after a server upgrade, so take a backup first.

Why does my query fail with 'Unknown function id()' after upgrading?▼

Cypher 25 removed the id() function, so replace it with elementId(). Note that elementId() returns a string like "4:abc123:0" rather than an integer, so update any stored IDs and WHERE clause comparisons that assumed numeric values.

What are the limitations of this Neo4j migration approach?▼

It does not write new Cypher queries, cover database administration tasks like backup and restore, or provision new Neo4j instances. GDS algorithm migration is also excluded and requires consulting the GDS release notes separately.

Related Skills

Explore More Software Engineering Skills→
eklyukineklyukin

neo4j-migration-skill

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

Community
Advanced
richardnpaulrichardnpaul

canary-watch

Monitor deployed URLs for regressions after deploys and merges.

Community
Intermediate
DebuggingInTearsDebuggingInTears

neo4j-cypher-skill

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

Official
Intermediate
neo4j-contribneo4j-contrib
101

neo4j-migration-skill

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

Official
Advanced