Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clear sequenced workflow, concrete formulas, and thresholds. Its weaknesses are token efficiency (heavy length and repetition) and progressive disclosure (most detail is inline in one large file rather than split into reference files).
Suggestions
Cut the redundant Purpose paragraph (it duplicates the frontmatter intent line) and condense the basic metric glosses like 'CAC (Customer Acquisition Cost)' that Claude already knows.
Move the four full recommendation-pattern templates and the ten Common Pitfalls into reference files under references/, leaving SKILL.md as an overview that links one level deep.
Collapse the repeated blank-laden template blocks into a single parameterized pattern to reduce repetition across the Scale / Optimize / Kill / Invest sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body runs ~640 lines with notable padding — the Purpose section restates the frontmatter intent nearly verbatim, recommendation templates repeat large blank-laden blocks, and basic metric definitions (e.g. 'CAC (Customer Acquisition Cost)') restate concepts Claude already knows. It is structured and instructional rather than pure fluff, so it clears level 1, but it could be tightened substantially. | 2 / 3 |
Actionability | It gives concrete formulas (CAC = Monthly Spend / Customers Acquired per Month; Magic Number = (New MRR × 4) / S&M Spend), numeric decision thresholds, a decision matrix, and four fully-specified recommendation patterns with enumerated options — copy-paste ready guidance. | 3 / 3 |
Workflow Clarity | Steps 0–5 are explicitly sequenced, each with 'Agent asks / calculates / flags' substeps, and the ✅/⚠️/🚨 flag bands act as evaluation checkpoints. Because this is advisory rather than a destructive/batch operation, the missing validate-retry loops do not cap the score. | 3 / 3 |
Progressive Disclosure | Sections are well organized, and external references are clearly signaled (workshop-facilitation skill, examples/ folder), but there are no bundle files and the long recommendation templates and ten inline Common Pitfalls are content that could be split into separate reference files, leaving a monolithic single file rather than an overview pointing one level deep. | 2 / 3 |
Total | 10 / 12 Passed |