Content
38%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive but overly verbose walkthrough of market opportunity analysis. It covers the right topics and has a logical structure, but it over-explains concepts Claude already knows, lacks executable artifacts, and references files that don't exist in the bundle. The content would benefit significantly from trimming explanatory text, adding concrete examples with actual numbers, and properly structuring supporting materials into referenced files.
Suggestions
Reduce content by ~50% by removing explanations of basic concepts (what TAM/SAM/SOM are, what data sources exist) and generic advice Claude already knows. Focus on the specific formulas, thresholds, and decision points.
Extract the report template (Step 8) into a separate referenced file like 'resources/report-template.md' and provide the actual file in the bundle.
Add a concrete worked example with real numbers (e.g., a complete mini-analysis for a hypothetical SaaS product) rather than the current illustrative conversation snippet.
Either provide the referenced 'resources/implementation-playbook.md' and 'market-sizing-analysis skill' files, or remove those references to avoid dead-end navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is significantly verbose, with extensive explanations of concepts Claude already knows (what TAM/SAM/SOM are, how to calculate them, what data sources exist). The 'Use this skill when' / 'Do not use this skill when' sections are generic filler. The 'What This Command Does' section redundantly previews the steps that are then fully detailed. Tips like 'Be conservative on SOM' and 'Cite all data sources' are basic analytical practices Claude already understands. | 2 / 5 |
Actionability | The skill provides structured steps and formulas (e.g., SAM = TAM × Geographic % × Product Fit % × Market Readiness %), which is somewhat concrete. However, there is no executable code, no actual data lookup examples, and the guidance remains at the level of structured instructions rather than copy-paste ready artifacts. The example usage is illustrative but not deeply actionable. | 3 / 5 |
Workflow Clarity | The 9-step workflow is clearly sequenced and logically ordered. However, validation is limited to a single variance check (Step 5's 30% threshold) with no explicit feedback loop for error recovery. The 'Validation and Sanity Checks' in Step 8 is just a report section heading, not an actual validation step in the workflow. There's no checkpoint to verify data quality before proceeding. | 3 / 5 |
Progressive Disclosure | The skill references 'resources/implementation-playbook.md' and a 'market-sizing-analysis skill' but no bundle files are provided, making these references unverifiable dead ends. The content is a monolithic ~200-line document that would benefit from splitting the report template, data source lists, and methodology details into separate files. The report template in Step 8 alone is substantial enough to warrant its own reference file. | 2 / 5 |
Total | 10 / 20 Passed |