You are an expert in creating competitor comparison and alternative pages. Your goal is to build pages that rank for competitive search terms, provide genuine value to evaluators, and position your product effectively.
33
30%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/competitor-alternatives/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a clear domain (competitor comparison pages) but suffers from vague goal-oriented language rather than concrete actions, lacks a 'Use when...' clause, and uses second person ('Your goal') which is inappropriate per the rubric guidelines. It would benefit significantly from listing specific actions and adding explicit trigger conditions.
Suggestions
Add an explicit 'Use when...' clause with trigger terms like 'competitor comparison', 'vs page', 'alternatives to [product]', 'comparison landing page'.
Replace vague goals with concrete actions, e.g., 'Creates feature comparison tables, writes SEO-optimized competitor vs. pages, drafts alternative product listings'.
Rewrite in third person voice (e.g., 'Creates competitor comparison pages...' instead of 'Your goal is to build...').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain ('competitor comparison and alternative pages') and some general actions ('build pages that rank', 'provide genuine value', 'position your product'), but these are more goals than concrete actions. It doesn't list specific tasks like 'create feature comparison tables' or 'write SEO-optimized headings'. | 2 / 3 |
Completeness | It describes what the skill does at a high level but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also somewhat vague, bringing this to 1. | 1 / 3 |
Trigger Term Quality | Includes some relevant terms like 'competitor comparison', 'alternative pages', and 'competitive search terms' that users might naturally use. However, it misses common variations like 'vs page', 'alternatives to X', 'competitor analysis', or 'comparison landing page'. | 2 / 3 |
Distinctiveness Conflict Risk | The focus on 'competitor comparison and alternative pages' is a reasonably specific niche, but the broader language about 'ranking for search terms' and 'positioning your product' could overlap with general SEO or marketing content skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a comprehensive but excessively verbose guide to creating competitor comparison pages. While it provides useful structural templates and page format definitions, it suffers from significant bloat—explaining marketing fundamentals Claude already knows, repeating patterns across similar sections, and including extensive placeholder-heavy templates inline rather than in separate reference files. The lack of validation steps for a content type where accuracy is critical (competitor claims) is a notable gap.
Suggestions
Reduce content by 60%+ by removing explanations of basic concepts (why honesty matters, what SEO is, what competitor pages are) and consolidating repetitive template patterns into a single parameterized template structure.
Split section templates, research process, and SEO considerations into separate bundle files (e.g., TEMPLATES.md, RESEARCH.md, SEO.md) and reference them from the main SKILL.md overview.
Add explicit validation checkpoints: verify competitor pricing/features against live sources before publishing, review claims for accuracy, and include a fact-checking step in the workflow.
Provide at least one fully realized example page (not just templates with placeholders) to demonstrate the expected output quality and tone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~500+ lines. Much of the content explains marketing concepts Claude already knows (what competitor pages are, why honesty builds trust, basic SEO concepts). The extensive YAML examples, section templates, and research process descriptions are padded with obvious guidance that doesn't add unique value. Could be reduced by 60-70% without losing actionable content. | 1 / 3 |
Actionability | Provides concrete templates and structural examples (YAML schemas, markdown templates, page structures) which are useful, but everything is placeholder-based ([Competitor], [Your Product]) with no real executable output. The templates are more like fill-in-the-blank frameworks than copy-paste-ready content. The research process section is entirely descriptive rather than instructive. | 2 / 3 |
Workflow Clarity | The page formats are well-structured with clear sections and ordering, and the content architecture section provides a logical data flow. However, there are no validation checkpoints—no steps to verify competitor data accuracy, no review process for claims, no feedback loops for ensuring pages are factually correct before publishing. For content that could misrepresent competitors, validation is important. | 2 / 3 |
Progressive Disclosure | Everything is crammed into a single monolithic file with no bundle files to support it. The content architecture section describes a competitor_data/ directory structure but no actual files exist. References to 'Related Skills' at the bottom point to other skills but the massive inline content (section templates, research process, SEO considerations, index page guidance) should be split into separate reference files. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (762 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
f5dc9e3
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.