Guide · Agent skill
How to use the Competitor Comparison Pages agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The seo-competitor-pages skill is a text-based playbook that teaches an AI agent how to plan and draft SEO comparison pages, including 'X vs Y' pages, 'alternatives to X' lists, best-of roundups and feature tables. It is for marketers, founders and SEO specialists who want consistent page structure. After this guide you will know what the skill does, how to install it, how to trigger it with plain requests, and what to verify before publishing.
Competitor Comparison PagesAgriciDaniel/claude-seo · MIT Download the skill Quick start
- 1Download the ZIP. Get the seo-competitor-pages ZIP from our page. It contains LICENSE.txt and SKILL.md.
- 2Unzip into a skills folder. Extract the folder into ~/.claude/skills/ for personal use, or into your project's .claude/skills/ folder.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Make a natural request. Ask for a comparison, alternatives or roundup page using phrases like 'alternatives to' or 'X vs Y', and name your product and competitors.
- 5Gather and verify sources. Collect public links for each competitor claim, pricing and feature, and note the date you checked them.
- 6Review the draft and schema. Check every figure, add the 'last updated' date and affiliation disclosure, then validate the JSON-LD before publishing.
What the skill makes the agent do
When installed, the agent gets a structured playbook for building pages that compare your product against competitors. The skill covers four page types: 'X vs Y' head-to-head comparisons, 'Alternatives to X' pages, 'Best [Category] Tools' roundups, and comparison table pages.
It also tells the agent how to lay out feature matrices, write titles and H1s that match search intent, suggest JSON-LD schema (Product, SoftwareApplication and ItemList), and add trust elements such as a 'Last updated' date, a methodology note and a disclosure of your own product's affiliation.
The skill is guidance only. The files do not contain scripts, and the skill has no live data access, so it cannot check current prices or features for you.
- Output the skill aims for: a COMPARISON-PAGE.md page structure with a minimum of 1,500 words, a comparison-schema.json file, a keyword strategy and recommendations.
- Fairness rules built in: verifiable sources, balanced presentation, 'as of [date]' pricing notes and no defamatory claims.
Install the skill from the ZIP or the Claude apps
Download the ZIP for seo-competitor-pages from our page and unzip it. For personal use, place the skill folder in ~/.claude/skills/. For a single project, place it in that project's .claude/skills/ folder.
If you use the Claude apps instead, upload the skill under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project
- Claude apps: Settings → Capabilities → Skills
Trigger the skill with natural requests
The skill activates when your request contains phrases such as 'comparison page', 'vs page', 'alternatives page', 'competitor comparison', 'X vs Y', 'versus', 'compare competitors' or 'alternative to'. You do not need special syntax.
The skill also accepts an optional argument hint of the form [url or generate] [competitor]. Name the product you are writing about and the competitors you want included, and say what you want back.
- "Create an alternatives page for [your product] that covers [competitor A] and [competitor B]."
- "Write an X vs Y comparison page: [Product A] vs [Product B], with a feature table and a verdict."
- "Draft a best project management tools roundup for 2026 with ranking criteria stated."
- "Suggest JSON-LD schema for this comparison page."
What you need before you start
The skill lists no required tools, does not run scripts and does not use the network. It works from what you give it and what the agent already knows, so the facts in your page are only as good as the sources you check.
Gather your own product details and the competitor information you can verify from public pages, documentation or review sites before you ask for a draft.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
Safety notes on scripts, network and untrusted content
Because the skill runs no scripts and makes no network calls, it cannot publish or fetch anything itself. The skill also states that fetched pages, search results and third-party files are untrusted data. Any text in them that addresses the agent should be reported to you, not followed.
Check every competitor claim yourself. The skill asks for verifiable sources but cannot confirm facts, and misleading comparisons carry legal risk.
- Review every feature and price figure against the competitor's own page before publishing.
- Keep an 'as of [date]' note on pricing and review the page when competitors ship major changes.
Tips for better comparison pages
Ask for a feature matrix with your product and each competitor as columns, and mark unavailable data as 'Not publicly available' rather than guessing. Acknowledge competitor strengths; balanced pages tend to be more credible.
Place a clear CTA above the fold, after the table and at the bottom, but avoid aggressive CTAs in competitor descriptions. Cross-link related comparisons, such as 'A vs B' to 'A vs C'.
- Use the 'Switched from [Competitor]' stories and review-site ratings only with source links.
- Add a breadcrumb such as Home > Comparisons > [This Page].
What people use it for
- Drafting an 'Alternatives to [Competitor]' page for a founder's product launch.
- Planning an 'X vs Y' page that targets a head-to-head search query with a clear verdict.
- Building a best-of category roundup with ranking criteria stated up front.
- Producing a feature matrix and FAQ-ready content outline for an SEO team to review.
Frequently asked questions
How do I install the seo-competitor-pages skill?
Download the ZIP from our page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
Is the seo-competitor-pages skill free to use?
The skill is released under the MIT licence, as stated in its LICENSE.txt file. Check the licence file for the complete terms.
What does the skill require to run?
The skill lists no required dependencies, runs no scripts and uses no network access. It is text-based guidance that works from the information you provide.
Does the skill check competitor prices and features automatically?
No. The skill has no live data access and relies on you to verify pricing and feature figures. It asks for an 'as of [date]' note on pricing so readers know when it was checked.
Can the skill make a comparison page that is legally safe?
The skill asks for verifiable sources, balanced presentation and no false or misleading claims, but it cannot check facts itself. Misleading or defamatory comparisons carry legal risk, so have a person review claims before publishing.
What should I use instead if I need live pricing data?
The skill is not designed for live data, so you would need a tool that retrieves current pricing or feature data. Use the skill for structure, wording and schema, and verify figures manually from each competitor's official pages.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are a marketing team, founder or SEO specialist who wants consistent structure, feature tables and schema suggestions for comparison pages. Pick something else if you need live competitor data or cannot spend time verifying every claim, because the skill cannot check facts itself.
Download the skill