Individual skill
seo-content-comparison-page
Spec, audit, competitor benchmark and build for the bottom-funnel pages that capture buyers at the decision moment: 'X vs Y', 'alternatives to X', 'best X for Y', the comparison hub, and audience or segment pages ('for agencies', 'for freelancers'). Runs four phases: the CMP spec with stable IDs on top of the common page spec, an audit of the existing page with seo_audit.py and section_audit.py, a benchmark against the comparison and alternatives pages that rank on the query (review sites, affiliate lists, the competitors' own vs pages) with page_benchmark.py, then the build: which comparisons deserve a page, URL mapping, a comparison table with sourced and dated competitor facts, the verdict, honest limitations, segment pages that are not find-and-replace, FAQ, schema and the acceptance re-run. Use when planning, auditing or writing comparison, alternatives, best-for or segment pages, when competitors rank for your brand plus alternatives, or when AI assistants recommend competitors on comparison prompts.
skills/seo-content-comparison-page/SKILL.md
Source commit a05ae4048445c9e39adfea27945de29db0499d31
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 11, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 18
- Repository last updated
- Nov 8, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- ai-search Repository topic
- claude-code Repository topic
- claude-skills Repository topic
- ecommerce-seo Repository topic
- generative-engine-optimization Repository topic
- geo Repository topic
- link-building Repository topic
- llm-seo Repository topic
- seo Repository topic
- social-media-marketing Repository topic
- marketing Derived category
- writing Derived category
- security Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 35,576 bytesSKILL.mdcore · 35,576 bytesSKILL.mdcore · 35,576 bytesSKILL.mdcore · 35,576 bytesSKILL.mdcore · 35,576 bytesSKILL.mdcore · 35,576 bytesSKILL.mdcore · 35,576 bytesevals/evals.jsonasset · 6,607 bytesreferences/comparison-page-patterns.mddoc · 11,496 bytes
Read excerpt
# Comparison, alternatives and segment pages
The last page a buyer reads before deciding. Someone searching "X vs Y" or "alternatives to X" has already accepted the category and is choosing a supplier: the highest-intent pages a site can own, and the format AI assistants reach for when asked to recommend, because a page that compares and concludes is directly usable as an answer.
Two rules make or break the category. The comparison must be verifiably true on the day it is published, and it must concede where a competitor genuinely wins. A page that wins every row, or that states last year's facts, is discounted by readers and by models alike.
## Company knowledge first (Obsidian)
If the working environment contains an Obsidian vault or any local knowledge base (a folder of .md notes, often with a .obsidian directory), read it before writing: the real feature set, real pricing, the competitors that actually come up in sales calls, the objections buyers raise, and the segments the business already serves. Comparison pages assert facts about third parties, so unsourced invention is both a credibility and a legal risk. Log the pages produced to the vault's SEO action log, including the date each comparison was verified, since that date drives the refresh cycle.
## When to use
- Planning, auditing or writing a "X vs Y", "alternatives to X", "best X for Y", comparison hub or segment page.
- Competitors, review sites or affiliates rank for "{your brand} alternatives" and you do not.