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-constructed instruction skill: the workflow is explicitly gated and checklisted, and the guidance is specific enough to execute without invention. Its weaknesses are redundancy — governance boilerplate and cross-skill routing repeated many times — and references that all live outside the bundle with no local supporting files.
Suggestions
State the propose-request protocol ('memory/events/claims.ndjson via an authorized operation: propose request to registry-events.py — never adjudicates') once in the Skill Contract and refer back to it elsewhere; it currently appears nearly verbatim five times.
Trim the Scope guard, which repeats the description's four 'not for X' exclusions almost word-for-word; a one-line summary plus the Reference Materials links would carry the same routing information at a fraction of the tokens.
Consolidate the inline cross-skill links scattered through the intro, Skill Contract, Instructions, and Next Best Skill into the annotated Reference Materials section to remove duplicated routing text and reduce the risk of link drift.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no explanations of known concepts), but the governance phrase 'via an authorized operation: propose request to registry-events.py' and the 'this skill never adjudicates' caveat are repeated roughly five times across the intro, Skill Contract, Instructions, and Save Results, and the Scope guard re-states the description's full exclusion list. This matches the 3 anchor (mostly efficient but could be tightened) rather than 2, since the padding is repetition of sentences, not whole padded sections. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: exact read/write paths (memory/narrative/story-bank-builder/, memory/claims/claims-ledger.md), concrete story-type definitions, an explicit arc-beat pattern (situation → tension → change → outcome), decision rules ('a story that fits no pillar is either orphaned (drop it) or a signal the pillar set is incomplete'), and a hard stop condition (NEEDS_INPUT). This matches the 5 anchor under the code-vs-instruction scoring note — no code is required, and the specific guidance covers the common cases. | 5 / 5 |
Workflow Clarity | The seven numbered steps are clearly sequenced with explicit validation checkpoints: step 1 gates on pillar existence with a NEEDS_INPUT stop, step 6 flags pillars lacking Measured or ledger-approved proof as an E-dimension risk, the 'Done when' section is a completion checklist, and conditional Next Best Skill routing handles the error-recovery paths. This matches the 5 anchor (clear sequence, explicit validation, feedback routing) rather than 4, where checkpoints would only be mostly present. | 5 / 5 |
Progressive Disclosure | The body has good section structure and a dedicated, annotated Reference Materials section with one-level-deep references, but no bundle files exist alongside SKILL.md (no references/, scripts/, or assets/ directories) — every link points outside the skill directory via fragile ../../../ relative paths that cannot be verified from the bundle — and the same cross-skill links are duplicated inline throughout the prose. This matches the 4 anchor (good structure, minor organization gaps) rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |