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.61x

Quality

96%

Does it follow best practices?

Impact

92%

1.61x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Quality

Content

92%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.

The body is highly actionable and well-structured with strong validation workflows and clean progressive disclosure to real reference files; the only minor weakness is a few inline deep-dive sections that slightly stretch conciseness.

Suggestions

Consider moving the extended QPE / conditional CALL / spatial code blocks into a reference file and keeping only a one-line pointer inline to tighten conciseness toward a 5.

The Syntax Traps inline table overlaps with references/syntax-traps.md; trimming the inline table to the top 5–6 traps and pointing out sooner would save tokens.

Dimension	Reasoning	Score
Conciseness	Dense, terse tables and rule lists with no padding ('Label-free MATCH (n) forbidden unless bound'), but the ~390-line body inlines several deep sections (QPE, conditional CALL, spatial, dynamic labels) that could be more aggressively offloaded to references; a few minor trims possible.	4 / 5
Actionability	Copy-paste-ready executable Cypher blocks, exact Query API v2 curl with real flags, specific EXPLAIN/PROFILE red-flag fixes, and concrete 'Wrong \| Right' trap tables covering common cases.	5 / 5
Workflow Clarity	Clear sequenced workflows with validation checkpoints: Pre-flight decision table, Schema-First Protocol priority order, Write Gate (EXPLAIN -> report -> user confirm), and a closing Checklist; batch/destructive CALL IN TRANSACTIONS ops carry explicit validation and a Failure Recovery feedback section.	5 / 5
Progressive Disclosure	Clear overview body with one-level-deep, well-signaled references (indexes, cypher-syntax, syntax-traps, performance, advanced-patterns, apoc, graph-type) — all verified real files under references/ — each with a one-line 'Load on demand' description for easy navigation.	5 / 5
	Total	19 / 20 Passed

Description

100%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.

The description is exemplary: it states concrete actions, gives natural trigger phrases, answers both what and when, and disambiguates from sibling skills with explicit negative boundaries.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Generates, optimizes, and validates Cypher 25 queries') and enumerates comprehensive coverage ('MATCH, MERGE, CREATE, WITH, RETURN, CALL, UNWIND, FOREACH, LOAD CSV, SEARCH, expressions, functions, indexes'), 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, plus explicit non-goals.	5 / 5
Trigger Term Quality	'Use when writing new Cypher queries, optimizing slow queries, graph pattern matching, vector or fulltext search, subqueries, or batch writes' provides natural trigger phrases users would actually say.	5 / 5
Distinctiveness Conflict Risk	Clear niche (Cypher query generation/validation) with explicit boundary statements ('Does NOT handle driver migration... use neo4j-migration-skill'; 'Does NOT cover DB administration... use neo4j-cli-tools-skill') minimizing conflict risk.	5 / 5
	Total	20 / 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: 02ad354

Reviewed: 3 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.