Content
96%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 an exceptionally dense, executable reference: every rule is paired with concrete Cypher, decision tables replace prose, and validation checkpoints (inspect-first, poll-until-ONLINE, confirm-before-write, severity-driven actions) cover the risky database operations. The only structural weakness is that all detail lives inline in a single long file with external-only references rather than a split bundle.
Suggestions
Move the Schema Enforcement DDL catalog and the Relational→Graph migration table into a reference file (e.g. references/ddl-catalog.md) referenced one level deep, keeping only the most common statements inline in SKILL.md.
Consider extracting the supernode mitigation strategies and bucket pattern into their own reference file, signaled from a short summary in the Key Patterns section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense decision tables, executable Cypher, and rules with zero explanation of concepts Claude already knows — e.g. "Nodes = entities (nouns) with identity; rels = connections (verbs) with direction" and the two-line bucket pattern example. Every section carries non-obvious domain guidance; matches the lean/efficient anchor, not the 4 anchor (which requires identifiable over-explanation to trim). | 5 / 5 |
Actionability | Guidance is copy-paste ready throughout: inspection queries ("CALL db.schema.visualization()..."), supernode detection ("count{ (n)--() } AS degree ORDER BY degree DESC LIMIT 10"), full DDL catalog ("CREATE CONSTRAINT person_id_unique IF NOT EXISTS FOR (p:Person) REQUIRE p.id IS UNIQUE"), and a concrete output-format template with severity semantics. Matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The workflow has explicit sequencing and validation checkpoints: "run first — never propose changes without current state", "poll until ONLINE" with the exact SHOW INDEXES query and "Do NOT use an index until state = ONLINE", "show + confirm first" for write-cypher, and a severity table mapping ERROR/WARNING/INFO to required actions, plus a final checklist. Feedback loops are present for the database operations context where the rubric demands them. | 5 / 5 |
Progressive Disclosure | Good structure: well-organized sections, a clearly signaled one-level "References — Load on demand" list with no nested references, and an MCP tool map. However it is a ~370-line monolithic file with no bundle files — the DDL catalog, migration table, and supernode mitigation material could plausibly live in reference files, so it fits the 'good structure, minor organization gaps' anchor rather than the 'content appropriately split' anchor. | 4 / 5 |
Total | 19 / 20 Passed |