Neo4j Agent Skills

Agent skills for Neo4j — Cypher queries, graph modeling, drivers, imports, GraphRAG, GDS, vector indexes, and Aura provisioning.

Browse and install at skills.sh/neo4j-contrib/neo4j-skills.

npx skills add https://github.com/neo4j-contrib/neo4j-skills

Configuration

Set these before or during installation:

Variable	Description
NEO4J_URI	neo4j+s://<dbid>.databases.neo4j.io (Aura) or neo4j://localhost:7687 (local)
NEO4J_USERNAME	Database username (default: neo4j)
NEO4J_PASSWORD	Database password
NEO4J_DATABASE	Target database (default: neo4j)

Installation

Antigravity

Install the plugin using the Antigravity CLI (agy):

agy plugin install https://github.com/neo4j-contrib/neo4j-skills

Verify installation with agy plugin list (or /plugin list inside an interactive agy session).

In the Antigravity app or IDE, open the Customizations tab in the sidebar and install Neo4j from the Marketplace, or clone this repository into ~/.gemini/config/plugins/neo4j-skills (global) or .agents/plugins/neo4j-skills (workspace).

If you are migrating from Gemini CLI, import existing Gemini extensions automatically:

agy plugin import gemini

Claude Code

/plugin marketplace add https://github.com/neo4j-contrib/neo4j-skills.git
/plugin install neo4j-skills@neo4j-skills-marketplace

Use /plugin list to verify, or /reload-plugins after installation.

Codex

codex plugin marketplace add neo4j-contrib/neo4j-skills
codex plugin add neo4j-skills@neo4j-skills-marketplace

Verify marketplace and plugin availability:

codex plugin marketplace list
codex plugin list

Start a new Codex thread after installation so Codex loads the plugin. To refresh later:

codex plugin marketplace upgrade neo4j-skills-marketplace

Available Skills

Querying & Modeling

Skill	Description
neo4j-cypher-skill	Write, optimize, and debug Cypher queries. Covers CYPHER 25 syntax, query planning, indexes, and common patterns.
neo4j-modeling-skill	Design and review graph data models. Covers node/relationship patterns, property choices, and relational-to-graph migration.
neo4j-getting-started-skill	Zero-to-app walkthrough: provision → model → load → query. Use for first-time setup on Aura or Docker.

Importing Data

Skill	Description
neo4j-import-skill	Load structured data (CSV, JSON) via LOAD CSV, neo4j-admin import, and the Data Importer GUI.
neo4j-document-import-skill	Extract knowledge graphs from unstructured documents and PDFs using SimpleKGPipeline.
neo4j-migration-skill	Upgrade drivers and Cypher from 4.x/5.x to 2025.x. Covers API changes, deprecated functions, and Cypher 25 syntax.

AI & Search