CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.28x
Quality

93%

Does it follow best practices?

Impact

86%

1.28x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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.

A high-quality, dense reference skill: executable examples throughout, an explicit pre-flight/schema-first workflow with validation gates and error-recovery feedback loops, and a real, well-organized reference bundle. The main improvement opportunities are trimming body sections that duplicate reference-file detail.

Suggestions

Move the DISJOINT BY, UUID type, and spatial/point sections (and their extended examples) into references (e.g., cypher-syntax.md / advanced-patterns.md), leaving one-line summaries with version gates in the body to cut token load.

Reduce the inline Common Syntax Traps table to the top 5–6 highest-frequency traps and defer the rest to references/syntax-traps.md to eliminate the partial duplication.

Add a boundary note for hybrid vector+fulltext search in the description (pointing to neo4j-vector-index-skill), since the body already routes hybrid search there.

DimensionReasoningScore

Conciseness

The body is dense and terse — tables, short bullets, and version-gated gotchas Claude would not know (e.g., "**`Z` ≠ UTC in Neo4j**", "`toInteger(null)` throws") with no padding explaining known concepts. It matches the level-4 anchor (efficient with minor instances that could be trimmed): the DISJOINT BY, UUID type, and spatial sections carry reference-grade detail that duplicates what the reference files already cover, and the inline trap table partially duplicates references/syntax-traps.md.

4 / 5

Actionability

Nearly every section gives copy-paste-ready Cypher: concrete MERGE/WITH/subquery/bulk-load examples, an exact curl command for the Query API v2, specific index/constraint DDL, and precise validation commands ("EXPLAIN before any write", "PROFILE to measure db hits; check for AllNodesScan, CartesianProduct, Eager"). This matches the level-5 anchor (fully executable, common cases covered); the one non-executable element (the schema sketch) is explicitly and appropriately justified ("Never fill guessed names").

5 / 5

Workflow Clarity

The multi-step process is explicitly sequenced with validation checkpoints: the Pre-flight decision table, the Schema-First Protocol priority order, the 4-step validation workflow (EXPLAIN → LIMIT 1 test → verify write half as RETURN → PROFILE), the write execution gate requiring user confirmation, plus a Failure Recovery section with fix-and-retry feedback loops and a closing checklist. This matches the level-5 anchor, including the database-operations feedback-loop requirement.

5 / 5

Progressive Disclosure

Eight real, one-level-deep reference files are well signaled — each with a descriptive entry in the References section and point-of-use links ("Full trap table → references/syntax-traps.md") — plus three real scripts. This is good structure matching the level-4 anchor; it falls short of level 5 because the ~430-line body inlines substantial detail (QPE patterns, DISJOINT BY, UUID, spatial, aggregation rules) that mirrors and partially duplicates the reference files, so the split between overview and detail is imperfect.

4 / 5

Total

18

/

20

Passed

Description

96%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 strong description: third-person voice, concrete verbs, an explicit Use-when trigger clause with natural phrasing, and clear negative-scope pointers to sibling skills. The only weakness is the un-fenced vector/fulltext search overlap with the neo4j-vector-index-skill.

DimensionReasoningScore

Specificity

"Generates, optimizes, and validates Cypher 25 queries" lists three concrete actions, and "Covers MATCH, MERGE, CREATE, WITH, RETURN, CALL, UNWIND, FOREACH, LOAD CSV, SEARCH, expressions, functions, indexes, and subqueries" enumerates comprehensive capability coverage. This matches the level-5 anchor (multiple specific concrete actions, comprehensive coverage), not level 4, since there are no meaningful coverage gaps in the actions named.

5 / 5

Completeness

The "what" is explicit ("Generates, optimizes, and validates Cypher 25 queries for Neo4j 2025.x and 2026.x") and the "when" is explicit with concrete triggers ("Use when writing new Cypher queries, optimizing slow queries, ..."). This clearly matches the level-5 anchor (both what and when with concrete trigger phrases), not level 4, since the when-clause is fully explicit rather than merely serviceable.

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" covers the natural phrasings a user would say for this need, including variations like "optimizing slow queries". This matches the level-5 anchor (comprehensive natural-term coverage with variations); there is no file-extension equivalent for a query-generation skill, and no commonly used trigger term for Cypher work is missing.

5 / 5

Distinctiveness Conflict Risk

Two explicit disambiguation fences are present ("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"), giving a mostly distinct niche. However, the "vector or fulltext search" trigger overlaps the sibling neo4j-vector-index-skill (which the body's When-NOT-to-Use section defers hybrid search to) and the description adds no boundary note for it, matching the level-4 anchor (minor overlap risk with a closely related skill) rather than level 5.

4 / 5

Total

19

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

Reviewed

Table of Contents

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.