neo4j-skills
Agent skills for Neo4j graph database — Cypher queries, graph modeling, drivers, imports, GraphRAG, GDS, vector indexes, and Aura provisioni
Open source Open in the app JSON README (API)
About
Agent skills for Neo4j graph database — Cypher queries, graph modeling, drivers, imports, GraphRAG, GDS, vector indexes, and Aura provisioning.
Details
- Kind
- Plugins
- Topic
- Databases
- Publisher
- neo4j-contrib
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.1
- Stars
- 106
- Forks
- 36
- Open pull requests
- 6
- Last push
- 2026-08-31T08:14:22Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
neo4j-contrib/neo4j-skills
README
# 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`](./neo4j-cypher-skill) | Write, optimize, and debug Cypher queries. Covers CYPHER 25 syntax, query planning, indexes, and common patterns. | | [`neo4j-modeling-skill`](./neo4j-modeling-skill) | Design and review graph data models. Covers node/relationship patterns, property choices, and relational-to-graph migration. | | [`neo4j-getting-started-skill`](./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`](./neo4j-import-skill) | Load structured data (CSV, JSON) via `LOAD CSV`, `neo4j-admin import`, and the Data Importer GUI. | | [`neo4j-document-import-skill`](./neo4j-document-import-skill) | Extract knowledge graphs from unstructured documents and PDFs using `SimpleKGPipeline`. | | [`neo4j-migration-skill`](./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`](./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`](./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`](./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`](./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`](./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`](./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`](./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`](./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`](./neo4j-driver-python-skill) | Python driver: `execute_query`, sessions, transactions, async, UNWIND batching, data types. | | [`neo4j-driver-javascript-skill`](./neo4j-driver-javascript-skill) | JavaScript/TypeScript driver v6: `executeQuery`, managed transactions, RxJS, data types. | | [`neo4j-driver-java-skill`](./neo4j-driver-java-skill) | Java driver: `ExecutableQuery`, managed/explicit transactions, object mapping, reactive. | | [`neo4j-driver-dotnet-skill`](./neo4j-driver-dotnet-skill) | .NET/C# driver: `ExecuteReadAsync`/`ExecuteWriteAsync`, DI registration, `IResultCursor`. | | [`neo4j-driver-go-skill`](./neo4j-driver-go-skill) | Go driver v6: `ExecuteQuery`, generic helpers, spatial types, connection configuration. | ### Frameworks & Platforms | Skill | Description | |---|---| | [`neo4j-graphql-skill`](./neo4j-graphql-skill) | Build GraphQL APIs backed by Neo4j using `@neo4j/graphql`. Covers type definitions, `@relationship`, `@cypher`, and filtering. | | [`neo4j-spring-data-skill`](./neo4j-spring-data-skill) | Spring Boot + Neo4j with Spring Data Neo4j: `@Node`, `@Relationship`, repositories, projections. | | [`neo4j-cli-tools-skill`](./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`](./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`](./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](LICENSE) file for details.