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.
The body is highly actionable, well-sequenced with validation checkpoints, and uses progressive disclosure effectively by offloading full operator and monitoring references to real bundle files. The only minor weakness is a few sections of light over-explanation that could be trimmed for token efficiency.
Suggestions
Trim the prose paragraphs under Cypher Runtime Selection (e.g., the pipelined/slotted/parallel narrative) and the curl Query API example — keep only the table and the inline forcing example to tighten token usage.
The EXPLAIN vs PROFILE table repeats concepts Claude already knows; consider condensing to a single line stating the key actionable rule (run PROFILE twice, first warms cache) and which metrics each exposes.
Remove tutorial-style notes like "Read plans bottom-up — leaf operators at bottom initiate data retrieval" if the same guidance is covered in references/plan-operators.md, to avoid duplicate explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and action-oriented — dense tables and code blocks assume Claude's competence and avoid explaining basics like "what Neo4j is". Minor instances of over-explanation remain (e.g., the prose around runtime selection and the curl Query API example), so it falls just below a perfect lean score. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready Cypher throughout — index creation, USING INDEX/SCAN/JOIN hints, CartesianProduct and Eager fix strategies, runtime selection, and monitoring/terminate commands — covering the common diagnostic cases concretely. | 5 / 5 |
Workflow Clarity | A clear 5-step "Diagnostic Workflow (Agent Runbook)" sequence (baseline → check indexes → create → profile → replan) with explicit validation checkpoints ("wait for state = 'ONLINE' before measuring", "Compare dbHits and elapsed ms before/after") and a closing checklist providing feedback loops for the database operations involved. | 5 / 5 |
Progressive Disclosure | SKILL.md serves as a well-organized overview with two clearly signaled, one-level-deep references to real bundle files — operator reference → references/plan-operators.md and monitoring → references/stats-and-monitoring.md — with bulk detail appropriately split out. | 5 / 5 |
Total | 19 / 20 Passed |