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-engineered instruction skill: a gated 7-step workflow with an explicit validation checklist, exact formulas, and a verified one-level-deep template reference. The main deductions are mild verbosity in the routing/cross-discipline prose, the absence of any fully populated numeric example (only placeholder templates and a NEEDS_INPUT example), and a web of references pointing outside the skill's own bundle.
Suggestions
Add one fully populated worked example (with sample numbers explicitly labeled Estimated and sourced) either inline or in references/templates.md, so the success path is demonstrated, not just the NEEDS_INPUT path.
Tighten the Cross-discipline ad-spend paragraph and the Next Best Skill section — the sibling-routing rules and termination logic could be condensed or moved to a reference file to reduce token cost.
Consolidate the many out-of-bundle links (shared contract, state model, connectors, and five sibling skills) into a single short 'Related skills' map, and make sure each target path resolves from the skill's directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious project rules (evidence labeling, NEEDS_INPUT policy, authorization gates, exact ROAS/ROI formulas) and never explains concepts Claude already knows. However, the Cross-discipline ad-spend paragraph and the Next Best Skill routing/termination prose run long and could be trimmed or pushed to a reference, matching 'efficient; minor instances of over-explanation that could be trimmed'. | 4 / 5 |
Actionability | Seven numbered steps each carry a per-step template link and precise executable rules ("sum to 100%", "ROAS = attributed revenue / spend", contingency and evidence-classification policies), and the Example block shows a complete output shape — mostly executable guidance. It falls short of the top anchor because the only fully worked inline example is the NEEDS_INPUT refusal path, and the referenced templates use unfilled $[X] placeholders, so no completed numeric allocation example exists anywhere in the bundle. | 4 / 5 |
Workflow Clarity | The Instructions section gives a clearly sequenced 7-step workflow with per-step gates (a rate without a compatible source 'stays NEEDS_INPUT'), and the 'Done when' contract is an explicit validation checklist (sums to 100%, every metric labeled with formula/refs/evidence window, named scenario or NEEDS_INPUT with an evidence-request plan). The NEEDS_INPUT evidence-request loop provides the error-recovery feedback path, matching the top anchor. | 5 / 5 |
Progressive Disclosure | Structure is good: the workflow and policies stay inline while templates, benchmarks, and scenario blocks live one level deep in references/templates.md (verified to exist with all seven linked Step sections, clearly signaled with section anchors). It is not the top anchor because many links (skill-contract.md, state-model.md, CONNECTORS.md, five sibling SKILL.md paths) point outside the bundle via ../../../ paths that cannot be verified here, and the routing/contract sections could themselves be split out. | 4 / 5 |
Total | 17 / 20 Passed |