# Neo4j Migration Skill

> Use when upgrading Neo4j drivers to new major versions

- Skill: `tomevault-io/neo4j-migration-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/neo4j-migration-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/neo4j-migration-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/neo4j-migration-skill

---


# Neo4j migration skill

This skill uses online guides to upgrade old Neo4j codebases. It handles all official Neo4j drivers.

## When to use

Use this skill when:
- a user asks to upgrade a Neo4j driver in languages: .NET, Go, Java, Javascript, Python

## Instructions

1. At the beginning, ALWAYS ask a user what Neo4j version is going to be used after the upgrade. Note, the Neo4j database's version is not upgraded as part of this skill, we just need that information
    a) If the user says that most recent, fetch the version from the [supported version list](https://neo4j.com/developer/kb/neo4j-supported-versions/) along with the most recent driver version
    b) Otherwise, analyze the [supported versions list](https://neo4j.com/developer/kb/neo4j-supported-versions/) and choose the most recent driver version for given Neo4j version

2. Analyze the codebase in order to determine what additional documentation to include, focus only on dependencies' files (e.g. `package.json`, `requirements.txt`, `pom.xml` etc.). If the codebase uses Neo4j driver for:
    - .NET then include [.NET migration guide](references/dotnet-driver.md)
    - Go then include [Go migration guide](references/go-driver.md)
    - Java then include [Java migration guide](references/java-driver.md)
    - Javascript/Node.JS then include [Javascript migration guide](references/javascript-driver.md)
    - Python then include [Python migration guide](references/python-driver.md)

Important: when you plan the upgrade, always include replacement of deprecated functions in the plan

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/neo4j-contrib) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

