---
slug: "neo4j-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/neo4j-contrib/neo4j-skills@main/README.md"
repo: "https://github.com/neo4j-contrib/neo4j-skills"
source_file: "README.md"
branch: "main"
---
# Neo4j Agent Skills

Agent skills for [Neo4j](https://neo4j.com) — Cypher queries, graph modeling, drivers, imports, GraphRAG, GDS, vector indexes, and Aura provisioning.

Browse and install at **[skills.sh/neo4j-contrib/neo4j-skills](https://skills.sh/neo4j-contrib/neo4j-skills)**.

```bash
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

```bash
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:

```bash
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

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

Verify marketplace and plugin availability:

```bash
codex plugin marketplace list
codex plugin list
```

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

```bash
codex plugin marketplace upgrade neo4j-skills-marketplace
```

## Available Skills

### Querying & Modeling

| Skill | Description |
|---|---|
| [`neo4j-cypher-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-cypher-skill) | Write, optimize, and debug Cypher queries. Covers CYPHER 25 syntax, query planning, indexes, and common patterns. |
| [`neo4j-modeling-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-modeling-skill) | Design and review graph data models. Covers node/relationship patterns, property choices, and relational-to-graph migration. |
| [`neo4j-getting-started-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-import-skill) | Load structured data (CSV, JSON) via `LOAD CSV`, `neo4j-admin import`, and the Data Importer GUI. |
| [`neo4j-document-import-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-document-import-skill) | Extract knowledge graphs from unstructured documents and PDFs using `SimpleKGPipeline`. |
| [`neo4j-migration-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-driver-python-skill) | Python driver: `execute_query`, sessions, transactions, async, UNWIND batching, data types. |
| [`neo4j-driver-javascript-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-driver-javascript-skill) | JavaScript/TypeScript driver v6: `executeQuery`, managed transactions, RxJS, data types. |
| [`neo4j-driver-java-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-driver-java-skill) | Java driver: `ExecutableQuery`, managed/explicit transactions, object mapping, reactive. |
| [`neo4j-driver-dotnet-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-driver-dotnet-skill) | .NET/C# driver: `ExecuteReadAsync`/`ExecuteWriteAsync`, DI registration, `IResultCursor`. |
| [`neo4j-driver-go-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-driver-go-skill) | Go driver v6: `ExecuteQuery`, generic helpers, spatial types, connection configuration. |

### Frameworks & Platforms

| Skill | Description |
|---|---|
| [`neo4j-graphql-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-graphql-skill) | Build GraphQL APIs backed by Neo4j using `@neo4j/graphql`. Covers type definitions, `@relationship`, `@cypher`, and filtering. |
| [`neo4j-spring-data-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/neo4j-spring-data-skill) | Spring Boot + Neo4j with Spring Data Neo4j: `@Node`, `@Relationship`, repositories, projections. |
| [`neo4j-cli-tools-skill`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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`](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/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](https://agentskills.io/specification).

## Contributing

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

## License

MIT — see the [LICENSE](https://github.com/neo4j-contrib/neo4j-skills/tree/HEAD/LICENSE) file for details.