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.
100
100%
Does it follow best practices?
Impact
100%
1.63xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the marks. It provides specific concrete actions, comprehensive trigger terms covering both high-level use cases and specific Cypher clauses, explicit 'Use when' guidance, and clear boundary definitions with redirects to related skills. The negative boundary statements are a particularly strong feature that would help Claude disambiguate between related Neo4j skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions ('Generates, optimizes, and validates Cypher 25 queries') and enumerates specific Cypher clauses and features (MATCH, MERGE, CREATE, vector/fulltext search, subqueries, batch writes, LOAD CSV, etc.). | 3 / 3 |
Completeness | Clearly answers 'what' (generates, optimizes, validates Cypher 25 queries with a comprehensive list of covered features) and 'when' (explicit 'Use when...' clause listing trigger scenarios). Also includes explicit boundary statements about what it does NOT handle, with redirects to other skills. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms a user would say: 'Cypher queries', 'Neo4j', 'graph pattern matching', 'vector search', 'fulltext search', 'slow queries', 'batch writes', plus specific clause names like MATCH, MERGE, LOAD CSV that users would reference directly. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche (Cypher 25 queries for Neo4j 2025.x/2026.x). The explicit 'Does NOT handle' clauses with redirects to specific alternative skills (neo4j-migration-skill, neo4j-cli-tools-skill) further reduce conflict risk. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exceptionally well-crafted skill that maximizes information density while maintaining clarity. It covers a complex domain (Cypher 25 query writing) with concrete executable examples, explicit validation workflows, comprehensive syntax trap tables, and well-organized progressive disclosure to reference files. The pre-flight decision table, version gates, and write execution gate demonstrate sophisticated workflow design with appropriate safety checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely dense and efficient. Every section earns its place — no explanations of what Cypher is, no hand-holding about graph databases. Tables, cheat sheets, and terse code examples maximize information density. The skill assumes Claude's competence throughout. | 3 / 3 |
Actionability | Fully executable Cypher examples throughout (MERGE, subqueries, CALL IN TRANSACTIONS, QPEs, spatial queries, schema inspection). The syntax traps table provides concrete wrong→right mappings. The Query API v2 curl command is copy-paste ready. Every pattern includes runnable code. | 3 / 3 |
Workflow Clarity | Clear multi-step workflows with explicit validation checkpoints: Pre-flight table for schema known/unknown, Schema-First Protocol with ordered inspection queries, Write Gate with EXPLAIN→confirm→execute sequence, and a final checklist. Failure recovery section provides systematic debugging steps. The EXPLAIN/PROFILE validation loop is explicit. | 3 / 3 |
Progressive Disclosure | Excellent structure: SKILL.md serves as a comprehensive but scannable overview with clear one-level-deep references to 7 specialized reference files (indexes, syntax, traps, performance, advanced patterns, APOC, graph-type). WebFetch URLs provide external fallback. Each reference is clearly labeled with its scope. Navigation is intuitive. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- neo4j-contrib/neo4j-skills
- Commit
66ed0e1
- 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.