Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured instruction-only skill with a clear workflow and excellent output template. Its main weaknesses are the lack of concrete guidance on how to actually collect reviews (no tools, APIs, or specific methods mentioned) and the somewhat verbose inline presentation that could benefit from splitting reference material into separate files. The frameworks and best practices sections add genuine value but contribute to overall length.
Suggestions
Add specific guidance on how to actually collect reviews — mention whether Claude should use web search, specific URLs/API patterns, or ask the user to paste reviews, since 'gather 50-100 reviews per competitor' is vague without tooling context.
Consider splitting the output format template and the frameworks/best practices tables into separate reference files (e.g., REVIEW_TEMPLATE.md, PLATFORMS.md) and linking to them from the main skill.
Trim the 'Common mistakes' section — items like 'Mining once and never returning' are advice for the founder, not actionable instructions for Claude performing the task.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some unnecessary elaboration. The 'Common mistakes' section and some of the framework tables add useful value, but sections like 'Context Required' and the detailed examples at the end could be tightened. The 'Related Skills' section is fine but the overall document is longer than it needs to be for an instruction-only skill. | 2 / 3 |
Actionability | The workflow steps are clear and the output format template is concrete and copy-paste ready. However, this is a research/analysis skill with no executable code or specific tool commands — the guidance on how to actually 'collect reviews' (step 2) is vague. There's no mention of specific tools, APIs, or scraping methods to gather the 50-100 reviews per competitor. The actionability relies heavily on Claude already knowing how to access these platforms. | 2 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced and logically ordered from scoping through collection, analysis, and output generation. Each step has specific sub-criteria (e.g., severity levels, frequency tracking). While there aren't explicit validation checkpoints, this is a research/synthesis task rather than a destructive operation, so the sequential flow with clear deliverables at each stage is appropriate. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and headers, and references related skills at the end. However, the document is quite long (~120 lines of content) and could benefit from splitting the frameworks/best practices and the detailed output template into separate reference files. Everything is inline in a single document when some content could be progressively disclosed. | 2 / 3 |
Total | 9 / 12 Passed |