Content
88%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 dense, high-precision instruction skill: fully executable formulas, a worked example, and a well-validated ten-step workflow with explicit NEEDS_INPUT checkpoints and a completion checklist. The deductions are minor — some repeated policy text and STAR gating detail that could live in the referenced benchmark file.
Suggestions
State the denominator-verification rule once (either the 'Done when' item or the paragraph after step 10) and reference it elsewhere, trimming the duplicated passage.
Move step 9's R1–R6 mapping detail into the referenced star-benchmark.md and keep only the handoff instruction inline, shortening the SKILL.md body.
Break step 6's single multi-clause sentence into a short checklist of LTV-input requirements for easier scanning.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body explains no concepts Claude already knows — its length is genuine precision policy — but the denominator-verification rule is stated twice ("Done when" item 4 and the paragraph after step 10) and step 6 packs roughly nine conditions into a single run-on sentence. Efficient with minor trimmable repetition fits anchor 4; it is not anchor 5 because not every token earns its place, and not 3 because nothing explained is unnecessary. | 4 / 5 |
Actionability | Every methodology has an explicit formula (Simple ROI, ROAS, both EMV bases, ((New Customers × contribution-margin LTV) − Investment) / Investment × 100, sum(attributed revenue)/sum(spend)), a full worked example with input and output, and per-step fill-in templates that exist in references/roi-templates.md with matching anchors. For an instruction-only skill this is copy-paste-ready guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Ten explicitly sequenced steps with per-step NEEDS_INPUT feedback loops (e.g., "If no valid comparator exists, return NEEDS_INPUT for EMV"), a four-item "Done when" checklist, mandatory denominator validation, a profitability-verification gate, and a termination rule (visited-set, max 3 hops). Clear sequence with explicit validation and error-recovery checkpoints matches anchor 5; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | Good one-level-deep structure: core formulas inline, bulk templates in the verified references/roi-templates.md, each step linked to its anchor block, and a described Reference Materials section. Falls short of anchor 5 because step 9's three paragraphs of STAR R1–R6 gating detail overlap the already-referenced star-benchmark.md, and numerous ../../../ cross-skill links are unresolvable within this bundle. | 4 / 5 |
Total | 18 / 20 Passed |