When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.
83
73%
Does it follow best practices?
Impact
99%
1.13xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/competitor-alternatives/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description with excellent trigger term coverage and clear completeness, explicitly answering both what and when. Its main weakness is that the 'what' portion could be more specific about concrete actions (e.g., 'generates comparison landing page copy, creates feature comparison tables') rather than primarily describing content formats. The cross-reference to the sales-enablement skill is a nice touch for disambiguation.
Suggestions
Add more specific concrete actions like 'Generates comparison landing page copy, creates feature-by-feature comparison tables, writes positioning statements' to strengthen the specificity dimension.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (competitor comparison/alternative pages) and mentions four formats (singular alternative, plural alternatives, you vs competitor, competitor vs competitor), but doesn't describe concrete actions like 'generates landing page copy' or 'creates structured comparison tables.' The capabilities are more about content types than specific actions performed. | 2 / 3 |
Completeness | Clearly answers both 'what' (create competitor comparison/alternative pages for SEO and sales enablement, covering four formats) and 'when' (explicit trigger terms and use cases listed). Also includes a helpful cross-reference to a related skill (sales-enablement) for disambiguation. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' 'competitor teardown.' These are terms users would naturally use when requesting this type of content. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche (competitor comparison content) and explicit boundary-setting by referencing the sales-enablement skill for sales-specific competitor docs. The specific trigger terms like 'vs page,' 'alternative page,' and '[Product] vs [Product]' create a well-defined scope unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%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-organized skill that covers four distinct competitor page formats with clear structures and URL patterns. Its main weaknesses are a lack of concrete examples (no sample page copy, comparison tables, or YAML data files) and some verbose sections that explain concepts Claude already understands (honesty in marketing, depth over surface). Adding executable examples and trimming the principles section would significantly improve it.
Suggestions
Add a concrete example of a completed comparison table or page section (e.g., a sample TL;DR summary or feature comparison for a hypothetical product pair) to improve actionability.
Show the actual YAML structure for the centralized competitor data file rather than just listing what it should contain.
Trim or remove the 'Core Principles' section—Claude understands honesty, depth, and helpfulness; replace with specific dos/don'ts or examples of good vs. bad comparison copy.
Add a validation step in the workflow, such as verifying competitor claims against their current website/pricing page before finalizing content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary content Claude would already know (e.g., 'Honesty Builds Trust' principles, 'Depth Over Surface' advice, and general SEO concepts like internal linking). The core principles section is largely common sense for an LLM. However, the page format structures and specific URL patterns add genuine value. | 2 / 3 |
Actionability | The skill provides clear page structures and URL patterns, which are useful templates. However, it lacks concrete examples of actual page copy, comparison tables, or YAML data structures. The output format section mentions 'YAML format' but doesn't show one. Much of the guidance is descriptive ('write a paragraph explaining the differences') rather than showing executable examples. | 2 / 3 |
Workflow Clarity | There's a reasonable sequence implied (assess → research → choose format → create content), and the initial assessment checklist is helpful. However, there are no explicit validation checkpoints—no step to verify competitor data accuracy, no review gate before publishing, and no feedback loop for checking claims against reality. For content that could misrepresent competitors, validation steps are important. | 2 / 3 |
Progressive Disclosure | The skill is well-structured with clear sections and appropriate references to external files (references/templates.md, references/content-architecture.md). Navigation is easy with clear headers, and the references are one level deep and well-signaled. Related skills are listed at the end for cross-referencing. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
2c7c108
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.