neo4j-cypher-skill SKILL.md skillA

neo4j-cypher-skill from neo4j-contrib/neo4j-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add neo4j-contrib/neo4j-skills/neo4j-cypher-skill@v1.0.31

Pins v1.0.31 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
neo4j-contrib/neo4j-skills
Path
neo4j-cypher-skill/SKILL.md
Versions recorded
19
Latest version
v1.0.31, committed Nov 2, 2026
First version recorded
Aug 13, 2026
Size
24,914 bytes
Repository stars
121
License
MIT

Generates, optimizes, and validates Cypher 25 queries for Neo4j 2025.x and 2026.x.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## When to Use
- Writing, optimizing, or debugging Cypher queries
- Graph pattern matching, QPEs, variable-length paths
- Vector/fulltext search, subqueries, batch writes, LOAD CSV

## When NOT to Use
- **Driver migration/API changes** → `neo4j-migration-skill`
- **DB admin** (users, config, backups) → `neo4j-cli-tools-skill`
- **Hybrid search that combines vector with fulltext or other ranked sources** → `neo4j-vector-index-skill`

GQL conformance note: `LET`, `FINISH`, `FILTER`, and `INSERT` are valid Cypher 25 clauses (introduced via GQL conformance, mostly in Neo4j 2025.06). On older versions, fall back to `WITH` / (omit RETURN) / `WHERE` / `CREATE`. `INSERT` requires `&`-separated multi-labels and does not support dynamic labels/types.

---

## Pre-flight

| ? | Known | Unknown |
|---|---|---|
| `<db-name>-schema.json` found in project | Use it directly — skip live inspection | — |
| Schema (from context or live DB) | Use directly | Run Schema-First Protocol |
| Neo4j version | Use version features | Default to 2025.01 safe set |
| Executing (not generating)? | Use EXPLAIN + write gate | State query is unvalidated |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add neo4j-contrib/neo4j-skills/neo4j-cypher-skill@sha256:fe905929ea87ea0c

The line at the top of this page pins the label v1.0.31, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tzlc6l7hu2g3wx7l.svg)](https://markdownregistry.com/a/art_tzlc6l7hu2g3wx7l)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 19 versions of this file, between Aug 13, 2026 and Nov 2, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.31 latest2026-11-02 22ea858 24,914 BA view · diff
v1.0.302026-10-19 4555b7b 24,677 BA view · diff
v1.0.292026-10-14 e00816d 24,576 BA view · diff
v1.0.282026-10-13 e83483a 24,576 BA view · diff
v1.0.272026-10-06 9005c19 24,576 BA view · diff
v1.0.262026-10-01 6e795bc 24,991 BA view · diff
v1.0.262026-09-30 c84b6f3 24,949 BA view · diff
v1.0.262026-09-30 b47f4a3 24,833 BA view · diff
v1.0.262026-09-30 1115072 25,005 BA view · diff
v1.0.252026-09-30 762cf09 24,833 BA view · diff
v1.0.252026-09-30 6e842b4 24,791 BA view · diff
v1.0.242026-09-17 a3627d2 24,594 BA view · diff
v1.0.232026-09-17 a3cc585 24,266 BA view · diff
v1.0.232026-09-17 5a92274 24,065 BA view · diff
v1.0.222026-08-19 e335859 22,708 BA view · diff
v1.0.222026-08-17 1b71882 22,532 BA view · diff
v1.0.212026-08-14 a40f76c 22,285 BA view · diff
v1.0.202026-08-14 5e29ed4 21,754 BA view · diff
v1.0.192026-08-13 c3e91d0 21,143 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (24914 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

neo4j-contrib/neo4j-skills · 121 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tzlc6l7hu2g3wx7l
GET https://markdownregistry.com/api/v1/resolve?ref=neo4j-contrib/neo4j-skills/neo4j-cypher-skill
GET https://markdownregistry.com/api/v1/blob/fe905929ea87ea0c50420b3d660a47ffa61b4e9e464f65587e0ee2d26353d316

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from neo4j-contrib/neo4j-skills

AGENTS.md AGENTS.md file
neo4j-contrib/neo4j-skills · AGENTS.md
git:20260922.a678fef · audit A · 121 stars
neo4j-agent-memory-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-agent-memory-skill/SKILL.md · Authoritative reference for the neo4j-agent-memory Python package — a graph-native memory system for AI agents built on…
v1.0.9 · audit A · 121 stars
neo4j-aura-agent-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-aura-agent-skill/SKILL.md · Manages Neo4j Aura Agents via the v2beta1 REST API — create, list, get, update, delete,
v1.1.0 · audit B · 121 stars
neo4j-aura-graph-analytics-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-aura-graph-analytics-skill/SKILL.md · Serverless Aura Graph Analytics (AGA) GDS Sessions — covers GdsSessions,
v1.0.13 · audit A · 121 stars
neo4j-aura-provisioning-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-aura-provisioning-skill/SKILL.md · Provisions and manages Neo4j Aura instances via CLI (aura-cli v1.7+) or REST API.
v1.0.5 · audit B · 121 stars
neo4j-cli-tools-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-cli-tools-skill/SKILL.md · Use when working with Neo4j command-line tools — neo4j-cli (modern unified
v1.0.15 · audit B · 121 stars
neo4j-document-import-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-document-import-skill/SKILL.md · Ingests unstructured and semi-structured documents into Neo4j as a knowledge graph.
v1.0.7 · audit A · 121 stars
neo4j-driver-dotnet-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-driver-dotnet-skill/SKILL.md · Neo4j .NET Driver v6 — IDriver lifecycle, DI registration (singleton), ExecutableQuery
v1.0.8 · audit A · 121 stars
neo4j-driver-go-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-driver-go-skill/SKILL.md · Covers the Neo4j Go Driver v6 — driver lifecycle, ExecuteQuery, managed and
v1.0.8 · audit A · 121 stars
neo4j-driver-java-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-driver-java-skill/SKILL.md · Neo4j Java Driver v6 — driver lifecycle, Maven/Gradle setup, executableQuery,
v1.0.12 · audit A · 121 stars
neo4j-driver-javascript-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-driver-javascript-skill/SKILL.md · Neo4j JavaScript/TypeScript Driver v6 — driver lifecycle, executeQuery,
v1.0.7 · audit A · 121 stars
neo4j-driver-python-skill SKILL.md skill
neo4j-contrib/neo4j-skills · neo4j-driver-python-skill/SKILL.md · Neo4j Python Driver v6 — driver lifecycle, execute_query, managed and explicit
v1.0.11 · audit A · 121 stars

Every file in neo4j-contrib/neo4j-skills

Browse by kind, by grade A, or by owner.