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.
An excellent body: a routing table, complete model templates, executable test patterns, a diagnostic table, and a final verification checklist, with details correctly pushed to one-level-deep reference files. The only weakness is mild redundancy in section lead-ins and test examples, which costs a single point on conciseness.
Suggestions
Drop lead-in sentences that restate the 2.1 table (e.g. 'Use this when a Cell model needs to replicate data to the Control silo') — the table already communicates the mixin choice.
Trim the 7.2 test examples to one fully-worked pattern plus one-line statements of what the remaining tests should assert, moving the rest to the referenced hybrid-cloud-test-gen material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and technical — blockquote constraints, a routing table, code-heavy steps — and assumes Claude's competence (no explanation of transactions, signals, or general Django concepts). Section lead-ins occasionally restate what the 2.1 table already conveys, and the test section carries four full example functions where the pattern is established after two. Not 5: minor trimming is possible; not 3: there is no padding of concepts Claude already knows. | 4 / 5 |
Actionability | Copy-paste-ready model templates with imports and manager wiring, executable test code using real utilities ('outbox_runner', 'outbox_context(flush=False)', 'assume_test_silo_mode_of'), and a debug table citing specific metrics ('outbox.coalesced_net_processing_time') and Celery tasks. Not 4: the only placeholders (e.g. 'my_mapping_service') are intentional template substitution points, not missing steps. | 5 / 5 |
Workflow Clarity | Step 1's intent-routing table dispatches to a sequenced Steps 2–8, a symptom→cause→investigation table provides an error-recovery loop, and Step 9 is an explicit pre-flight checklist that validates the batch/backfill operations. Not 4: validation checkpoints are explicit, not implicit; not capped at 3 because the checklist covers the destructive/batch cases. | 5 / 5 |
Progressive Disclosure | The body is an overview plus core templates; detail is split into four real reference files (all verified to exist and be substantive), each clearly signaled with 'Load references/... for...' and exactly one level deep — the single cross-link in debugging.md points to a sibling top-level file also directly reachable from SKILL.md. Not 4: the split is appropriate and navigation is trivial. | 5 / 5 |
Total | 19 / 20 Passed |