Content
71%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, actionable research workflow with concrete search strings, fetch targets, and output templates, and no wasted concept explanations. Its main weaknesses are the total absence of progressive disclosure (everything inlined, no references/) and only implicit verification checkpoints.
Suggestions
Move the two full output templates (competitor profile and landscape summary) into references/ files (e.g. references/profile-template.md, references/landscape-template.md) and keep one condensed example inline in SKILL.md.
Add an explicit verification step, e.g. cross-check pricing/positioning claims across at least two sources and flag data older than 6 months in each profile.
Make the Apify section concrete: name the actors or search patterns to use for Reddit, Twitter/X, and LinkedIn scraping, and what to do if a scrape returns nothing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is checklist- and template-driven with essentially no explanation of concepts Claude already knows, but the "Three layers" section restates the frontmatter description and lines like "Without Apify, web search covers the basics — just less structured" are trimmable. Efficient with minor over-explanation, matching anchor 4. | 4 / 5 |
Actionability | Gives exact search queries ("[company] funding", "[company] G2 reviews"), exact pages to fetch (/vs/, /alternatives/, /careers, /integrations), and complete output templates — highly actionable for an instruction-only skill. Not 5 because the Apify section says "scrape deeper data" without naming actors or concrete call patterns. | 4 / 5 |
Workflow Clarity | A clear five-phase sequence (Intake → Profile Research → Profile Output → Landscape Summary → Monitoring) with concrete sub-steps per dimension. Not 5 because verification is implicit — no explicit source-triangulation or data-staleness checkpoints — though no destructive or batch operations require feedback loops. | 4 / 5 |
Progressive Disclosure | Section headers are clear, but no reference files exist at all and the two full markdown output templates (~90 lines) are inlined in a ~190-line body where they could live in references/. Matches anchor 3 — content that should be separate is inline — rather than 4, which requires an appropriate reference split. | 3 / 5 |
Total | 15 / 20 Passed |