competitor-alternatives

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,' 'switch from competitor,' or 'comparison content.' Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. Emphasizes deep research, modular content architecture, and varied section types beyond feature tables.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./marketing-skill/skills/competitor-alternatives/SKILL.md

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, actionable skill body with good progressive disclosure to real reference and script files. Its main weaknesses are generic 'Core Principles' padding that hurts conciseness and the absence of an explicit end-to-end workflow with validation checkpoints.

Suggestions

Replace or trim the 'Core Principles' section and the 'You are an expert' opener — Claude already understands honest, in-depth comparison writing; keep only non-obvious guidance to improve conciseness.

Add an explicit numbered end-to-end workflow (assess context -> research competitors -> build Competitor Intelligence File -> generate pages -> verify claims) with a validation checkpoint before publishing to lift workflow_clarity.

Move the full per-format page structures into references/templates.md (already referenced) and keep only a one-line summary per format in the body to tighten progressive disclosure and conciseness.

Dimension	Reasoning	Score
Conciseness	Mostly efficient structured guidance, but the 'Core Principles' section (e.g. 'Honesty Builds Trust,' 'Depth Over Surface,' 'Help Them Decide') and the 'You are an expert...' opener are generic marketing philosophy Claude already understands, so it could be tightened.	3 / 5
Actionability	Provides concrete URL patterns, target keywords, numbered page structures, a real executable tool command ('python3 scripts/comparison_matrix_builder.py ...'), and pointed references to templates and architecture files; minor gaps keep it at 4 rather than 5.	4 / 5
Workflow Clarity	Steps are listed (research process, page section orders) and an implied assess-research-build sequence exists, but there are no explicit validation checkpoints or feedback loops tying the phases into one coherent workflow.	3 / 5
Progressive Disclosure	Clear overview body with well-signaled, one-level-deep references to real bundle files (references/templates.md, references/content-architecture.md, scripts/comparison_matrix_builder.py); some detailed page-format structures remain inline, so it stops at 4.	4 / 5
	Total	14 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-constructed description that clearly states what the skill does and when to invoke it, with a rich set of natural trigger terms and a distinct niche. The only minor gap is that the named 'actions' lean structural rather than enumerating distinct concrete operations.

Dimension	Reasoning	Score
Specificity	Names the domain and concrete actions ('create competitor comparison or alternative pages') plus four named formats, but the actions are somewhat high-level rather than a list of distinct concrete operations, so it sits at 4 rather than 5.	4 / 5
Completeness	Explicitly answers both 'what' (four formats, deep research, modular content architecture) and 'when' ('When the user wants to... Also use when the user mentions...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural triggers including synonyms and phrasings users actually say: 'alternative page,' 'vs page,' 'competitor comparison,' '[Product] vs [Product],' '[Product] alternative,' 'switch from competitor.'	5 / 5
Distinctiveness Conflict Risk	Clear niche (competitor comparison/alternative pages for SEO and sales enablement) with distinct, specific triggers that minimize overlap with adjacent marketing skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: marketing-skill/skills/competitor-alternatives/SKILL.md
Commit: 19392f7

Reviewed: ~2 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

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.