neo4j-cypher-skill

Generates, optimizes, and validates Cypher 25 queries for Neo4j 2025.x and 2026.x. Use when writing new Cypher queries, optimizing slow queries, graph pattern matching, vector or fulltext search, subqueries, or batch writes. Covers MATCH, MERGE, CREATE, WITH, RETURN, CALL, UNWIND, FOREACH, LOAD CSV, SEARCH, expressions, functions, indexes, and subqueries. Does NOT handle driver migration or API changes — use neo4j-migration-skill. Does NOT cover DB administration or server ops — use neo4j-cli-tools-skill.

1.18x

Quality

90%

Does it follow best practices?

Impact

77%

1.18x

Average score across 2 eval scenarios

Securityby

Low

Low-risk findings worth noting

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-structured Cypher skill with strong validation workflows and clean reference navigation. The main weaknesses are minor redundancy between inline content and the reference files, and a body that is heavier than a pure overview.

Suggestions

Collapse the duplication between the inline Key Patterns examples (string interpolation, UUID, GROUP BY) and their restatement in the Version Gates table — keep one canonical location and link from the other.

Move the full Version Gates table to a references file (e.g. references/version-gates.md), retaining only the 2025.01 safe-baseline defaults inline to slim the body.

Relocate the detailed spatial/point and multi-clause QPE worked examples to references/advanced-patterns.md, keeping only the minimal pattern template inline in SKILL.md.

Dimension	Reasoning	Score
Conciseness	Dense, reference-style content that assumes Cypher competence with almost no padding, but several topics (string interpolation, UUID, GROUP BY) appear both inline in Key Patterns and again in the Version Gates table, creating redundancy that could be trimmed.	4 / 5
Actionability	Abundant copy-paste-ready Cypher examples with the CYPHER 25 prefix, a concrete curl Query API v2 command, and named scripts, covering the common cases (MERGE, WITH, subqueries, bulk writes, QPE, spatial) fully and executably.	5 / 5
Workflow Clarity	Clear sequencing with explicit validation checkpoints (Pre-flight table, Schema-First Protocol priority order, EXPLAIN/LIMIT 1/RETURN-then-write gate, write execution gate), feedback loops in Failure Recovery, and a closing Checklist — including validation for batch/destructive operations.	5 / 5
Progressive Disclosure	Well-signaled one-level-deep references (8 reference files + 3 scripts, all present and described in a Load-on-demand section) with easy navigation, but the 440-line body inlines substantial detail (full Version Gates table, multiple worked pattern examples) that partly duplicates the reference files.	4 / 5
	Total	18 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, well-scoped description that concretely states capabilities, gives natural trigger terms, and draws crisp boundaries against sibling skills. The only minor gap is a few missing natural synonyms in the trigger list.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ("Generates, optimizes, and validates Cypher 25 queries") plus a comprehensive clause inventory (MATCH, MERGE, CREATE, WITH, RETURN, CALL, UNWIND, FOREACH, LOAD CSV, SEARCH), matching the comprehensive-coverage anchor.	5 / 5
Completeness	Explicitly answers both what ("Generates, optimizes, and validates Cypher 25 queries...") and when ("Use when writing new Cypher queries..."), with concrete trigger phrases — the anchor-5 pattern.	5 / 5
Trigger Term Quality	Strong natural triggers ("writing new Cypher queries, optimizing slow queries, graph pattern matching, vector or fulltext search, subqueries, batch writes") users would actually say; a few synonyms (e.g. "traverse", "graph database queries", "path queries") are absent, so it sits just below the comprehensive anchor.	4 / 5
Distinctiveness Conflict Risk	Clear Cypher-25-for-Neo4j niche with explicit boundary redirects ("Does NOT handle driver migration... use neo4j-migration-skill", "Does NOT cover DB administration... use neo4j-cli-tools-skill"), minimizing wrong-skill triggering.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: neo4j-contrib/neo4j-skills
Path: neo4j-cypher-skill/SKILL.md
Commit: a3627d2

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.