Content
78%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 highly actionable, well-sequenced research workflow with copy-paste search commands and a complete output template — its strongest qualities. Its weaknesses are the absence of any bundle structure (everything, including a very long output template, is inlined in SKILL.md) and minor duplication between the usage-trigger sections.
Suggestions
Move the ~135-line battlecard output template to a one-level-deep reference file (e.g., references/battlecard-template.md) and link to it from Phase 3, keeping SKILL.md as a lean overview.
Merge the 'When to Use' and 'Trigger Phrases' sections, which repeat the same example phrases, into a single section.
Add an explicit validation checkpoint between Phase 1 and Phase 3, e.g., 'Before writing the card, confirm every claimed strength/weakness cites a source (review quote, pricing page, or ad) — downgrade unsourced claims in the Confidence field.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient — search-query blocks, a strengths/weaknesses matrix, and the output template all earn their tokens, and it never explains concepts Claude already knows. Not a 5 because the 'When to Use' and 'Trigger Phrases' sections duplicate the same example phrases, and the ~135-line inline template could be tightened. | 4 / 5 |
Actionability | Fully copy-paste-ready guidance: literal search strings ('Search: "[competitor]" site:g2.com OR site:capterra.com'), explicit fetch targets per phase, a complete fill-in battlecard template, and a concrete save path ('clients/<client-name>/product-marketing/battlecards/vs-[competitor-slug]-[YYYY-MM-DD].md'). Covers the common cases end-to-end. | 5 / 5 |
Workflow Clarity | The Phase 0 → 1A-1E → 2 → 3 sequence is explicit and well-decomposed, and the skill is neither destructive nor batch so no hard cap applies. Not a 5 because verification is only implicit (a 'Confidence: High/Medium' output field) — there is no explicit checkpoint to validate that research findings are sourced before generating the card. | 4 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers, but the skill is a single ~280-line monolith with zero external references: the ~135-line battlecard output template and the research query blocks are content that could live in one-level-deep reference files. Matches the 3 anchor ('some structure... content that should be separate is inline'). | 3 / 5 |
Total | 16 / 20 Passed |