neo4j-contrib/neo4j-skills
29 skills9.9k installs2.9k starsGitHub
Install
npx skills add https://github.com/neo4j-contrib/neo4j-skillsSkills in this repo
1Neo4j Cypher Skillneo4j-cypher-skill version 1.0.1 targets Neo4j 2025.x and 2026.x with Cypher 25 as the required first token on every query. It enforces a schema-first protocol using project schema JSON or live SHOW INDEXES/CONSTRAINTS inspection, default LIMIT 25 on exploratory reads, MERGE only on constrained keys, and a write execution gate requiring EXPLAIN before mutations. Coverage spans MATCH, MERGE, QPE path expressions, CALL IN TRANSACTIONS bulk loads, vector SEARCH clause 2026.01+, fulltext indexes, and six on-demand references including a 40+ entry syntax-traps table. Developers reach for neo4j-cypher-skill when writing new graph queries, debugging slow patterns, or validating batch writes against a real schema instead of guessing labels and relationship types.841installs2Neo4j Modeling Skillneo4j-modeling-skill is a draft agent skill from neo4j-contrib/neo4j-skills that guides designing and reviewing Neo4j graph data models. It helps choose node labels versus relationship types versus properties, migrate relational or document schemas to graph form, and detect anti-patterns such as overly generic nodes or missing constraints. Install via npx skills add https://github.com/neo4j-contrib/neo4j-skills --skill neo4j-modeling-skill. Developers reach for neo4j-modeling-skill before agents generate Cypher or ORM mappings, ensuring graph schemas stay queryable, constrained, and free of modeling smells.550installs3Neo4j Graphrag Skillneo4j-graphrag-skill is an agent skill from neo4j-contrib/neo4j-skills for building GraphRAG retrieval pipelines on Neo4j with the neo4j-graphrag Python package at v1.16.0 or newer. It covers six built-in retrievers—VectorRetriever, HybridRetriever, VectorCypherRetriever, HybridCypherRetriever, Text2CypherRetriever, and ToolsRetriever—plus external vector DB retrievers for Weaviate, Pinecone, and Qdrant. The workflow includes embedder setup, index creation, retrieval_query Cypher fragments, query_params, filters, token usage tracking, Cypher 25 SEARCH clause usage, and LangChain or LlamaIndex integration. LLM providers span OpenAI, Anthropic, VertexAI, Bedrock, Cohere, Mistral, and Ollama. Developers reach for it when agents need graph-aware RAG rather than flat vector search alone. It does not handle knowledge-graph construction. Outputs include a wired GraphRAG pipeline, retriever config, and LLM prompt templates.533installs4Neo4j Document Import Skillneo4j-document-import-skill is a draft agent skill from neo4j-contrib that walks developers through importing unstructured documents into Neo4j as a knowledge graph. The skill covers PDF and text chunking strategy, LLM entity extraction via SimpleKGPipeline, the no-code LLM Graph Builder path, apoc.load.json bulk loading, and LangChain or LlamaIndex document loaders. Developers reach for neo4j-document-import-skill when building RAG backends, semantic search, or graph-augmented agents that need entities and relationships materialized in Neo4j rather than flat vector indexes alone. Install via npx skills add against the neo4j-contrib/neo4j-skills repository; extended reference docs cover entity resolution and advanced chunking when the base SKILL.md overflows.440installs5Neo4j Driver Python Skillneo4j-driver-python-skill guides Python developers through the official Neo4j Python Driver v6 for production graph apps. It covers driver installation and singleton lifecycle with verify_connectivity, URI schemes and auth for Aura, bolt, bearer, and Kerberos, plus execute_query with RoutingControl and result_transformer_. Managed transactions via execute_read and execute_write include retry safety, result lifetime rules, and @unit_of_work; implicit session.run covers LOAD CSV and CALL {} IN TRANSACTIONS. AsyncGraphDatabase patterns support FastAPI lifespan hooks and asyncio.gather, with explicit handling for ConstraintError and related exceptions. Use it when wiring real Python services to Neo4j, not for Cypher-only query writing without driver code.426installs6Neo4j Vector Index Skillneo4j-vector-index-skill from neo4j-contrib/neo4j-skills teaches developers to stand up semantic search on Neo4j graph data. The workflow covers CREATE VECTOR INDEX with dimensions and similarity functions, waiting for ONLINE status via SHOW VECTOR INDEXES, and Python batch ingestion using UNWIND with db.create.setNodeVectorProperty. For embeddings inside Cypher, ai.text.embed() (2025.12) replaces deprecated genai.vector.encode(), and ai.text.embedBatch() handles large datasets. Vector queries use the SEARCH clause (2026.01+) with db.index.vector.queryNodes() as a fallback, then combine results with graph traversal for hybrid RAG patterns.420installs7Neo4j Getting Started Skillneo4j-getting-started-skill is the official Neo4j contributor skill that orchestrates a zero-to-running-app pipeline across eight ordered stages: prerequisites, context, provision, model, load, explore, query, and build. Each stage reads its own reference file and supports both human-in-the-loop and fully autonomous operation, with documented time budgets of 15 minutes or less autonomous and up to 90 minutes with HITL. Developers reach for neo4j-getting-started-skill when starting a new Neo4j project from scratch, provisioning Aura, generating synthetic data, building a notebook or application, or running the full onboarding pipeline. The skill explicitly does not cover standalone Cypher authoring—that belongs to neo4j-cypher-skill—nor driver upgrades or CLI admin on existing databases. It produces a provisioned graph, loaded dataset, explored schema, working queries, and a runnable app or notebook artifact.414installs8Neo4j Agent Memory Skillneo4j-agent-memory-skill teaches agents to build graph-native memory using the neo4j-agent-memory Python package and the hosted Neo4j Agent Memory Service (NAMS) at memory.neo4jlabs.com. It covers MemoryClient and MemorySettings APIs, short-term conversation history as :Message nodes, long-term knowledge via the POLE+O entity model (Person, Object, Location, Event, Organisation), and reasoning traces for auditability. Developers can wire memory into LangChain, CrewAI, or expose it through a Memory MCP server with NAMS API keys (nams_ prefix). Reach for this skill when agents need structured recall beyond flat vector stores, not when a simple key-value cache suffices.406installs9Neo4j Query Tuning Skillneo4j-query-tuning-skill is an agent skill that walks solo builders and small teams through Neo4j Cypher performance diagnosis end to end. It teaches when to use EXPLAIN versus PROFILE, how to read plans bottom-up, and which operators signal missing indexes, bad cardinality, or expensive graph traversals. The skill pairs operator-level fix strategies with planner hints and runtime selection guidance for slotted, pipelined, and parallel execution, including Enterprise-only capabilities where noted. It also covers operational tooling—SHOW QUERIES, SHOW TRANSACTIONS, transaction termination, and db.stats-style retrieval—so you can fix slow queries without guessing. Reference files deepen coverage of plan operators and stats/monitoring. Install via agentskills.io for Claude Code-style agents when your app depends on Neo4j and latency or cost spikes trace back to Cypher.397installs10Neo4j Import SkillNeo4j-import-skill guides coding agents through importing structured CSV data into Neo4j with the right tool for scale and environment. Solo builders shipping knowledge graphs, recommendation backends, or analytics on Aura benefit from explicit branching: Neo4j Data Importer for sub-million-row, low-Cypher workflows with drag-and-drop files, versus LOAD CSV batched with CALL IN TRANSACTIONS for larger sets, plus pointers to neo4j-admin import for offline bulk. The skill spells access paths in Aura, standalone importer URLs, and constraints such as string-only properties in the GUI importer. It is phase-specific backend work—invoke when CSVs and a graph model are ready, not during marketing or SEO. Marked draft upstream; pair with your own validation on production-sized files.393installs11Neo4j Gds Skillneo4j-gds-skill is an agent skill from neo4j-contrib/neo4j-skills for Neo4j Graph Data Science on Aura Pro, self-managed, local, or offline DBMS instances with the GDS plugin installed. The skill covers native and Cypher graph projection, execution modes—stream, stats, mutate, and write—and seven core algorithms: PageRank, Louvain, WCC, Betweenness Centrality, Node Similarity, FastRP, and KNN. It documents the FastRP-to-KNN recommendation pipeline, writing node embeddings for Neo4j vector indexes, and memory estimation before large projections via the graphdatascience Python client. Developers reach for neo4j-gds-skill when shipping community detection, centrality scoring, or structural similarity search without guessing GDS mode semantics or blowing heap on unestimated projections.391installs12Neo4j Genai Plugin SkillNeo4j GenAI plugin skill teaches agents to use Neo4j’s native ai.text.* functions so solo builders can run embeddings, text completion, structured JSON outputs, and chat without bolting a separate orchestration service onto every retrieval query. It fits builders shipping knowledge-heavy agents or SaaS features where the graph is the system of record: configure providers, discover available models, chunk by tokens, and chain vector search with traversals and LLM steps inside Cypher. The skill is explicit about version gates—2025.12+, CYPHER 25, Aura GenAI enabled—and points vector index mechanics to a sibling skill. That makes it a focused integration reference, not a full Python GraphRAG pipeline guide. Install when you are implementing GraphRAG or entity-aware copilots on Neo4j; skip if you only need index DDL or offline batch ETL in another language. Expect agents to need API credentials and careful review of queries that touch production graphs.367installs13Neo4j Security SkillNeo4j Security Skill teaches agents how to manage Neo4j security programmatically through Cypher and configuration patterns: users, roles, privilege grants, inspection, and Enterprise-only controls. Solo builders shipping knowledge graphs, recommendation backends, or internal tools on Neo4j need this when default admin access is no longer acceptable and RBAC must be expressed as repeatable commands. The skill documents CREATE and ALTER USER flows, role grants, DENY semantics, property-level access per label, sub-graph restrictions, and ABAC rules tied to OIDC claims, plus SHOW PRIVILEGES patterns suitable for export and audit. Community edition covers basic RBAC; property-level, sub-graph, ABAC, LDAP, and SSO scenarios require Enterprise. It deliberately excludes application query authoring, neo4j-admin cluster operations, and driver session management, deferring to neo4j-cypher-skill, neo4j-cli-tools-skill, and driver-specific skills. Install via the neo4j-contrib skills package when hardening a graph deployment or automating least-privilege rollouts alongside infra changes.359installs14Neo4j Graphql Skillneo4j-graphql-skill guides solo builders through building a GraphQL API backed by Neo4j using the Neo4j GraphQL Library—currently documented for v7 with v5 LTS paths. It covers constructor setup, index and constraint assertion, rich type definitions, relationship directions, custom @cypher resolvers, JWT/JWKS security on fields, auto-generated CRUD, OGM for trusted server-side access, subscriptions, and federation hooks with Apollo. Invoke it when you are writing typeDefs, securing fields, or wiring Neo4j to Apollo Server, and reach for neo4j-cypher-skill when you need Cypher outside GraphQL resolvers. The README marks the skill as draft/WIP; treat examples as living and verify against your installed @neo4j/graphql major version. Intermediate complexity assumes you already run a Neo4j instance and understand basic graph modeling.358installs15Neo4j Aura Provisioning Skillneo4j-aura-provisioning-skill is a draft agent skill for solo and indie builders who need Neo4j Aura online without guessing CLI flags or API flows. It walks through provisioning managed graph instances, managing lifecycle operations, and handling secrets in pipelines so agents do not leak credentials in chat logs. The same package explains Aura Agent, Neo4j’s no-code console agent that loops through interpret → plan tools → execute read-only Cypher → respond, which suits quick retrieval assistants and prototypes before you commit to a custom LangGraph stack. Prerequisites are explicit: enable Generative AI assistance and Aura Agent in org settings, and ensure tool authentication is on for the project (default for newer orgs). Use it when you are standing up Aura for an AI feature, graph RAG, or knowledge graph MVP and want repeatable steps your coding agent can follow end to end.348installs16Neo4j Aura Graph Analytics SkillNeo4j Aura Graph Analytics Skill teaches agents how to use Neo4j’s serverless GDS environment: ephemeral sessions billed per minute, isolated from embedded plugins. Solo builders adding recommendations, fraud rings, or community detection to a product get step-by-step guidance for Aura API credentials, choosing memory tiers, creating and reconnecting sessions, projecting graphs remotely from AuraDB or external stores, running mutate stream and write modes, polling async jobs, and streaming properties back into applications. It explicitly separates concerns from embedded GDS and from raw Cypher skills, reducing mixed camelCase and snake_case mistakes in the Python client. Advanced but narrow—ideal when your architecture already points at Aura Business Critical or VDC and graphdatascience 1.15 or newer.345installs17Neo4j Spark SkillNeo4j Spark Skill teaches coding agents how to move graph data between Apache Spark and Neo4j using the official Neo4j Connector for Apache Spark. Solo builders and small data teams use it when standing up batch sync from a lakehouse into a knowledge graph, or exporting graph slices for ML feature stores on Databricks, EMR, or standalone Spark. Coverage includes SparkSession dependency wiring, mutually exclusive read options for label, Cypher, and relationship scans, and write semantics including MERGE via node.keys. You get operational knobs for partitions and batch size plus Databricks-specific install and secrets guidance. The skill explicitly defers Cypher authoring, the Python bolt driver, GDS, and Spring Data to sibling Neo4j skills so agents do not mix incompatible stacks. Pair it during build when your product needs scheduled graph hydration rather than interactive Cypher-only apps.337installs18Neo4j Driver Go SkillNeo4j Driver Go Skill packages procedural knowledge for building backend Go services on Neo4j Go Driver v6. Indie developers shipping APIs or internal tools use it when they need correct connection handling, query execution style, and error semantics without reading the entire driver manual. The skill centers neo4j.ExecuteQuery as the default happy path, then documents when managed read/write transactions or explicit BeginTransaction better fit streaming or cross-function work. It maps Go types to Cypher safely, propagates context deadlines, and explains retry behavior around connectivity failures. Batch ingestion via UNWIND and bookmark management for causal consistency are included for production-shaped code. It deliberately excludes Cypher authoring and v5→v6 migration, pointing to sibling neo4j-skills for those concerns. Advanced pool sizing and repository wrappers live in referenced markdown for when defaults are not enough.332installs19Neo4j Driver Java SkillNeo4j-driver-java-skill teaches agents how to write production-grade Java and Kotlin against the official Neo4j Java Driver v6. Solo builders and small teams reach for it when a product needs graph relationships—recommendations, permissions, knowledge graphs—without guessing transaction boundaries or leaking sessions. The skill spans dependency setup, managed and explicit transactions, async and reactive entry points, and practical mapping rules such as null-safety with asString and containsKey. It deliberately excludes Cypher authoring, version migrations, and Spring Data Neo4j, pointing to sibling skills for those concerns so the agent does not mix ORM patterns with the low-level driver. Compatibility is stated as Driver v6, Java 17+, and Kotlin 1.9+. Use it during backend implementation when stack traces involve ServiceUnavailableException, TransientException, or incorrect parameter typing in UNWIND batches.331installs20Neo4j Kafka SkillNeo4j Kafka Skill is an agent skill for solo builders and small teams who need Neo4j graphs in motion with Apache Kafka or Confluent Cloud. It documents how to install and operate the Neo4j Connector for Kafka on self-managed Connect (Confluent Hub or direct JAR) or use the managed sink in Confluent Cloud without local JAR plumbing. Coverage spans sink configuration strategies—from Cypher and pattern mapping to CDC and CUD flows—plus exactly-once semantics and dead-letter handling when records fail validation. On the source side it explains CDC-driven streaming where the edition supports it and query-based polling elsewhere, including the native db.cdc.query API and cursor-loop patterns in Python and Java. Schema Registry integration for Avro and JSON Schema is included so agents do not guess wire formats. The skill defers Cypher authoring, bulk file import, and GDS algorithms to sibling Neo4j skills, keeping this package focused on event-driven graph sync. Expect intermediate data-engineering familiarity with Connect workers, topics, and Neo4j credentials.329installs21Neo4j Driver Dotnet SkillNeo4j Driver Dotnet Skill is a reference-style agent skill that keeps solo .NET builders from guessing Neo4j.Driver v6 APIs when shipping graph-backed features. It documents installation, singleton driver lifecycle with VerifyConnectivityAsync, dependency-injection registration, and when to choose ExecutableQuery versus ExecuteReadAsync and ExecuteWriteAsync managed transactions. Coverage extends through IResultCursor consumption, safe record access, Cypher-to-.NET type mapping including temporal types and ElementId caveats, UNWIND batching with dictionaries or anonymous types, and Preview-level AsObject mapping. Error handling emphasizes exception hierarchy and rollback-safe patterns. The skill deliberately points Cypher authoring to neo4j-cypher-skill and upgrades to neo4j-migration-skill so this package stays focused on connection and execution correctness. Use it while building APIs, workers, or internal tools that persist relationships in Neo4j; skip it if you are on another language driver or not using Neo4j at all.325installs22Neo4j Aura Agent Skillneo4j-aura-agent-skill packages a solo-builder workflow for Neo4j Aura Agents—GraphRAG assistants backed by AuraDB. It targets indie developers who already have graph data in Aura and want repeatable agent setup instead of one-off console clicking. The skill walks schema discovery (including vector index detection), maps real graph shape to the three first-class tools, and drives agent lifecycle through authenticated REST calls with prompts and exposure modes. Install when you are wiring RAG or analytics chat into a product and need agents that respect your ontology rather than generic retrieval. Prerequisites are explicit: enabled Generative AI and Aura Agent in the org, project admin rights, client credentials, and org/project IDs from the console. Use uv-synced Python helpers to list agents, create from config, and smoke-test NL queries before you expose MCP or public REST endpoints to end users.317installs23Neo4j Snowflake Graph Analytics SkillNeo4j Snowflake Graph Analytics Skill teaches agents to use Neo4j Graph Analytics for Snowflake—a Native Application that exposes graph algorithms as SQL procedures on warehouse tables. Solo builders and small data teams install it when they need PageRank, Louvain, Dijkstra, node similarity, and related workloads without exporting data to a separate graph cluster. The skill walks through marketplace setup, privilege grants, compute pool sizing, projection definitions, and the repeatable project-compute-write workflow. It also helps pick algorithms for fraud detection, recommendations, and entity resolution, chain multi-step jobs, and fix projection or permission failures. Expect intermediate Snowflake and SQL fluency; outputs are runnable SQL and configuration patterns aligned with Neo4j’s current Snowflake documentation.312installs24Neo4j Nvl Skillneo4j-nvl-skill is an agent skill for solo builders shipping graph-aware SaaS or internal tools who need Neo4j Visualization Library (NVL) wired correctly the first time. It walks through @neo4j-nvl/base for nodes, relationships, rendering options, and export, @neo4j-nvl/interaction-handlers for zoom, pan, selection, and keyboard UX, and @neo4j-nvl/react wrappers for React 19 apps. You learn when to pick Canvas2D versus WebGL2, how to choose layouts from forceDirected through d3Force, and how to connect live Cypher results via nvlResultTransformer instead of hand-mapping records. The skill deliberately excludes Needle’s GraphVisualization defaults, Python/Jupyter ports, raw Cypher authoring, driver lifecycle, and GDS—pointing you to sibling Neo4j skills for those concerns. Use it while building dashboards, agent memory graphs, or analytics UIs on Neo4j 1.1+ in modern browsers.271installs25Neo4j Mcp Skillneo4j-mcp-skill enables Claude to integrate Neo4j graph databases through MCP—configure tools, write Cypher, inspect schemas, and fetch relationship-rich results for agent and API workflows needing graph-native context.127installs26Neo4j Cli Tools Skillneo4j-cli-tools-skill teaches agents to use Neo4j command-line utilities for administering graph databases, running Cypher, inspecting schemas, and managing data import pipelines. It supports backend teams building relationship-heavy features on Neo4j during implementation and troubleshooting.115installs27Neo4j Migration Skillneo4j-migration-skill is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.78installs28Neo4j Driver Javascript SkillGuides writing JavaScript or TypeScript code against Neo4j using the v6 driver, covering executeQuery, managed read/write transactions, session.run, Integer and temporal types, and async error handling. A developer uses it when connecting a Node.js or browser app to Neo4j, not for authoring Cypher.1installs29Neo4j Spring Data SkillCovers Spring Data Neo4j (SDN) usage in Spring Boot including entity mapping, repositories, projections, and Spring AI Neo4jVectorStore integration. A developer uses it when wiring a Spring Boot application to Neo4j; content is marked draft/WIP with placeholder sections.1installs