Content
81%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-structured, actionable routing skill with explicit validation checkpoints and clean navigation. The main lever is conciseness: the sibling-routing list is restated in several sections and could be consolidated once with short back-references.
Suggestions
Consolidate the repeated sibling-skill routing list (content-writer, ad-creative-builder, etc.) into a single Scope-guard block and reference it from Instructions step 6 and the Reference Materials list instead of restating it.
Move the dense Skill-Contract Reads/Writes/Promotes prose into a short bulleted contract with the memory paths as code spans, so the validation gates stand out from the routing narration.
The 'Data Sources' and 'Instructions §Treat input as untrusted' both cover untrusted-input handling and connector usage — merge the connector/robots detail into Data Sources and keep Instructions to the workflow step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence — it never explains what a canon or a surface is — but the Scope-guard paragraph repeats the sibling-skill routing list nearly verbatim across multiple sections and could be tightened. | 4 / 5 |
Actionability | Gives concrete file paths, exact memory directories ('memory/narrative/narrative-cascade-planner/', 'memory/claims/claims-ledger.md'), and authorized 'operation: propose' calls to registry-events.py; minor gaps only because no executable code is present, which is acceptable for a routing-and-spec skill. | 4 / 5 |
Workflow Clarity | A 7-step numbered sequence with explicit validation and branching checkpoints — canon-exists check returning NEEDS_INPUT, baseline-mapper routing when absent, ask-before-write prompts, and a 'Done when' checklist — provides clear error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | Well-organized sections (Quick Start, Skill Contract, Data Sources, Instructions, Reference Materials) with one-level-deep, clearly signaled references; no bundle files exist, and the inlined contract detail is the only thing keeping it from a 5. | 4 / 5 |
Total | 17 / 20 Passed |