Content
92%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 very strong skill body: terse, version-aware guidance Claude could not reconstruct from general knowledge, fully executable examples, and a complete validation workflow with a write gate. The only improvement area is trimming Key Patterns subsections that duplicate cypher-syntax.md content.
Suggestions
Trim the Key Patterns subsections whose content is already promised by references/cypher-syntax.md (string interpolation, UUID type, map-related notes) down to one-line pointers, keeping only the highest-frequency patterns inline.
Move the multi-row Version Gates fallbacks for rarely needed features (e.g. GQL function aliases, map comprehension) into a version-compat reference file, keeping only the most common gates in SKILL.md.
Consider shortening the Spatial/Point subsection to the bounding-box pattern plus a pointer, since point() function semantics are standard knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is extremely dense and telegraphic with no concept-padding (no "what is a graph database" prose), and version-sensitive detail is properly concentrated in a Version Gates table with fallbacks rather than scattered. However, several Key Patterns subsections (UUID, spatial/point, string interpolation, GROUP BY) inline material that the reference list says cypher-syntax.md already covers, which could be trimmed from the overview. | 4 / 5 |
Actionability | Fully executable guidance throughout: complete Cypher code blocks with CYPHER 25 prefixes and parameters, exact SHOW/CALL schema-inspection commands, a copy-paste curl example for Query API v2, and a wrong/right trap table with concrete replacements. This matches the copy-paste-ready, common-cases-covered anchor. | 5 / 5 |
Workflow Clarity | Multi-step workflows are clearly sequenced with explicit validation checkpoints: the Pre-flight decision table, the Schema-First Protocol priority order, a validation workflow ("EXPLAIN before any write", test reads with LIMIT 1, verify write half as RETURN before SET/CREATE/DELETE, PROFILE for db hits), a write execution gate requiring user confirmation, a failure-recovery section, and a final checklist. Validation for destructive/batch operations is present, so the workflow cap does not apply. | 5 / 5 |
Progressive Disclosure | The body works as a well-structured overview with a dedicated "References — Load on demand" section where each of the seven reference files is described, and all referenced paths (plus the three scripts) exist as real one-level-deep files. Only the top syntax traps are inlined with "Full trap table → references/syntax-traps.md", showing appropriate splitting between overview and detail. | 5 / 5 |
Total | 19 / 20 Passed |