Content
86%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, highly actionable skill body with a clear sequenced workflow and excellent progressive disclosure via real one-level references. The main opportunity is tightening the inlined forcing-question library and removing the 'Do not use for'/'Distinct from' overlap to improve conciseness.
Suggestions
Move the forcing-question library (questions 1–7 with canon citations) into a dedicated reference file and keep only a one-line pointer in SKILL.md to reduce body length and improve conciseness.
Merge the 'Do not use for' and 'Distinct from' sections — they overlap heavily — into a single consolidated boundary section.
Add an explicit validate-then-proceed checkpoint between workflow steps (e.g., 'confirm cost-to-serve report flagged no double-counting before running the ROI analyzer') to strengthen workflow_clarity toward a 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is mostly specialized domain knowledge (anti-patterns, canon citations, ratios like 'MDF < 5:1') rather than basics Claude already knows, but the ~157-line body carries an elaborate inlined forcing-question library and overlap between 'Do not use for' and 'Distinct from' that could be trimmed. | 4 / 5 |
Actionability | Fully executable guidance: concrete commands with real flags ('scripts/cost_to_serve_calculator.py --input channel.json --output markdown', '--profile {saas,api,enterprise-software,marketplace,hardware}', '--sample'), a copy-paste quick example, and expected outputs per step covering the common cases. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (Intake → cost-to-serve → ROI → mix → Decide) with described data handoffs and built-in script validation (overhead-consistency check, double-counting flags), but it lacks explicit validate→fix→retry feedback loops in the narrative; the non-destructive analytical nature means the batch/destructive cap-at-3 does not apply. | 4 / 5 |
Progressive Disclosure | The body is an overview pointing to one-level-deep, clearly signaled references that all exist — 3 reference canons, 3 scripts, and the channel_data_template — with easy navigation, matching the clear-overview anchor. | 5 / 5 |
Total | 18 / 20 Passed |