Content
63%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.
The body delivers a concrete, well-sequenced market-sizing methodology with formulas and validation, but it is padded with generic boilerplate and duplicated headers, and its single reference to supporting material is a dangling path with no actual bundle files. Progressive disclosure is weak because all detail lives inline.
Suggestions
Remove the generic '## Instructions' boilerplate and the '## Use this skill when / Do not use this skill when' sections that restate the description without adding detail, and merge the duplicate '## Instructions' and '## Instructions for Claude' headers.
Fix the dangling 'resources/implementation-playbook.md' reference by either creating the file or removing the pointer, and verify the 'market-sizing-analysis skill' dependency is real.
Move the large Section 1-9 report template into a referenced file (e.g. references/report-template.md) so SKILL.md stays a lean overview with one-level-deep navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient methodology with concrete formulas, but includes generic boilerplate ('Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.'), duplicated '## Instructions' and '## Instructions for Claude' headers, and Do/Don't padding, matching 'Mostly efficient but includes some unnecessary explanation or could be tightened'. It is not a 4 because the boilerplate and redundancy are clearly trimmable. | 3 / 5 |
Actionability | It provides concrete formulas (TAM = Σ Segment Size × ACV; SAM = TAM × Geographic % × Product Fit % × Market Readiness %), specific SOM percentages (2-3% Year 3, 4-6% Year 5), named data sources, and a defined report structure, fitting 'Mostly executable guidance; concrete code or commands with minor gaps'. As an instruction-only skill the absence of code is acceptable; it is not a 5 because there is no worked numeric example covering the common case. | 4 / 5 |
Workflow Clarity | The process is clearly sequenced Step 1 through Step 9 with an explicit validation checkpoint (top-down within 30%, 'If variance > 30%, investigate and explain') and a dedicated 'Validation and Sanity Checks' section, matching 'Clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because the validation feedback loop is light (no re-computation loop) and checkpoints beyond the TAM variance check are descriptive rather than enforced. | 4 / 5 |
Progressive Disclosure | Section structure exists, but the entire methodology/report template is inlined in SKILL.md and the one external reference ('resources/implementation-playbook.md') points to a file that does not exist in the bundle, plus a reference to an external 'market-sizing-analysis skill'; this matches 'Some structure but could be better organized; references present but not clearly signaled'. It is not a 4 because of the dangling reference and the lack of any real one-level-deep supporting files. | 3 / 5 |
Total | 14 / 20 Passed |