Content
82%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 well-built reference skill: fully executable Cypher for every function, a validation-gated write workflow, correct provider details, and proper offloading of the full provider table to a real one-level reference file. The remaining gaps are minor — inline version tags and asides that pad conciseness, no retry loop in the write gate, and some reference material that could move out of SKILL.md.
Suggestions
Conciseness: consolidate the scattered version tags ([2025.11], [2026.03], [2026.04]) into the existing Deprecated/'old patterns' section or a single version-compatibility note, and drop the 'Key insight (Bergman)' aside or fold it into the GraphRAG example comment.
Workflow clarity: extend the Write Gate into an explicit feedback loop — e.g. 'if the test-node embed returns null or errors, check the Common Errors table, fix config, and re-run the test node before batching' — instead of a one-shot verification step.
Progressive disclosure: move the Common Errors table and the Chat section detail into a reference file (e.g. references/errors.md) with a clearly signaled link, keeping SKILL.md as a tighter overview pointing one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense reference: no explanations of concepts Claude already knows, and content is delivered as code blocks, tables, and a checklist. However, time-sensitive version tags ("[2025.11]", "[2026.03]", "[2026.04]") are scattered inline outside the dedicated Deprecated section, and editorial asides like "Key insight (Bergman): shortest path between seed nodes..." are trimmable — minor over-explanation that could be cut, matching anchor 4 rather than the lean anchor 5. | 4 / 5 |
Actionability | Every section gives copy-paste-ready, complete Cypher (e.g. the GraphRAG pattern embedding → SEARCH → traverse → completion in one query), plus procedure signatures, a Common Errors table with cause and fix per error, and a pre-flight checklist. This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The Write Gate sequences bulk writes with explicit checkpoints: "1. Count nodes first ... 2. Verify config with one test node before batch 3. Use CALL { ... } IN TRANSACTIONS OF 500 ROWS 4. Require explicit confirmation", and the Common Errors table supports recovery — so the batch-operation cap at 3 does not apply. It falls short of anchor 5 because there is no explicit validate → fix → retry feedback loop (e.g. re-run the test node after a failed config rather than proceeding). | 4 / 5 |
Progressive Disclosure | The bundle structure is sound: the body keeps only a provider quick-reference summary and offloads the full table to the real, one-level-deep references/providers.md, signaled clearly both inline ("Full provider config table → [references/providers.md]") and in a References section. It is not anchor 5 because the body still carries substantial reference material inline (Common Errors table, Chat section, Deprecated table) that could be split out, leaving SKILL.md closer to a pure overview. | 4 / 5 |
Total | 17 / 20 Passed |