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

Gemini CLI

gemini extensions install https://github.com/neo4j-contrib/neo4j-skills

Enter your env vars when prompted. Then run gemini and use /extensions list to verify.

Antigravity CLI

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

agy plugin import gemini

This auto-converts the gemini-extension.json manifest and copies skills into .agents/skills/. Then run agy and use /plugins list to verify.

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

Skill Description
neo4j-vector-index-skill Create and query vector indexes for semantic similarity search. Covers index creation, embedding ingestion, and ai.text.embed() [2025.12].
neo4j-genai-plugin-skill In-Cypher LLM integration via ai.text.* functions [2025.12]: embeddings, text completion, structured output, chat, tokenization, and pure-Cypher GraphRAG.
neo4j-graphrag-skill Build GraphRAG retrieval pipelines with neo4j-graphrag. Covers retriever selection (VectorCypherRetriever, HybridCypherRetriever), retrieval_query patterns, and LangChain/LlamaIndex integration.
neo4j-agent-memory-skill Graph-native agent memory: short-term (conversations), long-term (POLE+O entity model), and reasoning traces. Covers neo4j-agent-memory, NAMS, MCP, LangChain, CrewAI, ADK.
neo4j-mcp-skill Set up and use the Neo4j MCP server for tool-based agent access to the database.

Graph Data Science

Skill Description
neo4j-gds-skill Run GDS algorithms with the embedded GDS plugin on Aura Pro, self-managed, local, or offline Neo4j.
neo4j-aura-graph-analytics-skill Run serverless Aura Graph Analytics sessions via Python client or AuraDB Cypher API projection/session management.
neo4j-snowflake-graph-analytics-skill Run Neo4j Graph Analytics algorithms (PageRank, Louvain, WCC, Dijkstra, KNN, Node2Vec) directly inside Snowflake without moving data.

Drivers

Skill Description
neo4j-driver-python-skill Python driver: execute_query, sessions, transactions, async, UNWIND batching, data types.
neo4j-driver-javascript-skill JavaScript/TypeScript driver v6: executeQuery, managed transactions, RxJS, data types.
neo4j-driver-java-skill Java driver: ExecutableQuery, managed/explicit transactions, object mapping, reactive.
neo4j-driver-dotnet-skill .NET/C# driver: ExecuteReadAsync/ExecuteWriteAsync, DI registration, IResultCursor.
neo4j-driver-go-skill Go driver v6: ExecuteQuery, generic helpers, spatial types, connection configuration.

Frameworks & Platforms

Skill Description
neo4j-graphql-skill Build GraphQL APIs backed by Neo4j using @neo4j/graphql. Covers type definitions, @relationship, @cypher, and filtering.
neo4j-spring-data-skill Spring Boot + Neo4j with Spring Data Neo4j: @Node, @Relationship, repositories, projections.
neo4j-cli-tools-skill DB admin via neo4j-admin, cypher-shell, aura-cli, and neo4j-cli (preview unified CLI). Covers backups, imports, user management, Aura provisioning, and agent skill install.
neo4j-aura-provisioning-skill Create and manage Neo4j Aura instances via the Aura CLI and REST API. Covers async polling, credential handling, and tier selection.
neo4j-aura-agent-skill Create, configure, and invoke Aura Agents via the v2beta1 REST API. Covers CypherTemplate, SimilaritySearch, and Text2Cypher tools, system prompts, REST/MCP deployment, and OAuth2 auth.

What are Agent Skills?

Agent Skills are a standardized format for domain-specific AI agent knowledge. Each skill bundles step-by-step instructions, on-demand reference docs, and executable scripts — loaded progressively to keep context lean. See agentskills.io/specification.

Contributing

Pull requests welcome — new skills or improvements to existing ones.

License

MIT — see the LICENSE file for details.