Content
88%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |