Guide · Agent skill
How to use the alternatives-pages agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The alternatives-pages skill is a set of instructions that teaches an AI agent to draft '[Competitor] alternative' and '[Your product] vs [Competitor]' web pages for developer tools. This guide explains what the skill makes the agent do, how to install it, how to ask for help with natural requests, and what to check before you publish anything. No prior experience with agent skills is needed.
Quick start
- 1Download the ZIP. Download the alternatives-pages ZIP file from this page. It contains README.md and SKILL.md.
- 2Unzip into a skills folder. Unzip the package into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder for one project.
- 3Or upload it in the Claude apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the skill.
- 4Describe your page. Ask for an alternatives or comparison page and name your product and the competitor. Add the use case and your target developers.
- 5Review the draft. Check every claim, price and feature against current sources, and remove anything you cannot verify.
- 6Confirm permissions. Check brand-use permission before using competitor logos or trademarks, and decide whether to name the competitor at all.
- 7Schedule updates. Set a reminder to re-check the comparison and update the 'Last updated' date so the page stays accurate.
What the alternatives-pages skill does
Once the skill is installed, your agent can write competitive landing pages for a developer tool. It follows a structure built around keyword research, a hero section, honest comparison tables, migration guidance, FAQs and a verdict. The aim is copy that is more useful to developers and less salesy.
The skill works from the instructions in its SKILL.md file. According to the assessment, it does not run any code. The skill's own principles are to be honest, helpful, specific and current, because developers will fact-check the page.
- Keyword groups for alternative, comparison, migration and problem-aware searches
- A page outline for alternatives pages and for direct 'you vs them' comparison pages
- Guidance on comparison tables, including nuanced indicators such as Partial, Beta and Roadmap
- Migration sections, FAQs and a verdict that says who should choose each product
Install the alternatives-pages skill
Download the ZIP file for the skill from this page. The package contains README.md and SKILL.md. Unzip it so that the skill folder sits in one of the locations below.
You can install it for yourself across projects by unzipping into ~/.claude/skills/. You can also install it for a single project by unzipping into that project's .claude/skills/ folder.
If you use the Claude apps, you can upload the skill instead. Open Settings, go to Capabilities, then Skills, and upload the skill there.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills
Trigger the skill with natural requests
You do not need a special command. Ask for the page in plain language and include the names of your product and the competitor. The skill's trigger phrases include 'alternatives page', 'comparison page', 'vs page', '[competitor] alternative' and 'competitor comparison'.
Give the agent context it cannot guess, such as your product's use case, who your target developers are and which features you genuinely beat the competitor on. The skill asks you to focus on differences that matter to your ideal customer.
- Write an alternatives page for [Your product] as a [Competitor] alternative for small backend teams.
- Draft a vs page comparing [Your product] with [Competitor], neutral in tone, with a comparison table and a verdict.
- Give me keyword ideas for '[competitor] alternative' and migration searches.
- Outline a migration section for developers switching from [Competitor].
Build a page the skill's way
For an alternatives page, the skill's outline runs from hero section to CTA: headline, why developers switch, key differences, comparison table, migration, social proof, FAQ and calls to action. For a comparison page, the outline is hero, quick comparison, detailed table, deep-dive analysis, migration information and verdict.
The comparison table guidance is strict. Include features where the competitor is stronger, avoid misleading indicators, date the comparison and link to sources so readers can verify claims. Where a judgement is subjective, the skill says to label it as subjective and invite readers to test for themselves.
- Do not cherry-pick only the features you win on
- Show pricing so readers can compare it
- Mark subjective points such as ease of use as subjective
- Use 'Last updated' with a date you fill in
Check the output before you publish
The skill gives no fact-checking. Every feature claim, price and competitor detail in the draft must be verified against current sources by you or your team. Outdated or inaccurate claims can damage trust and may create legal problems.
The skill's risk field is marked critical in its file header, which is a reason to review the output carefully. It also warns about using competitor logos or trademarks without checking brand-use permissions. Use product names in the hero section and add logos only after you have confirmed you may use them.
The skill's files state that it runs no scripts and uses no network access. It only supplies written guidance to the agent.
- Verify every feature, price and claim against current documentation
- Confirm trademark and logo permissions before use
- Decide whether to name the competitor or keep the page general
- Plan regular updates so the comparison does not go stale
What people use it for
- A founder writing a first '[Competitor] alternative' page for a developer tool
- A marketing team planning a set of 'vs' pages for competitors that come up in sales deals
- A content writer building a repeatable structure for competitive landing pages
- A product marketer drafting a migration guide outline for developers switching tools
Frequently asked questions
Is the alternatives-pages skill free to use?
The skill is released under the MIT licence, as stated in its file header. Check the licence file that accompanies the package for the full terms.
What do I need to install alternatives-pages?
The item lists no requirements. You need an agent environment that supports skills, a place to unzip the skill folder or the Claude apps' Skills setting, and the downloaded ZIP file.
Does the skill run scripts or access the internet?
No. The assessment states it does not run scripts and does not use the network. It works from the instructions in SKILL.md.
Where do I put the skill folder?
Unzip it into ~/.claude/skills/ to make it available for you, or into .claude/skills/ inside a project folder to use it only there. In the Claude apps, you can upload it under Settings, Capabilities, Skills.
Will the skill check my competitor facts for me?
No. The skill gives no fact-checking, so you must verify every claim, price and feature yourself before publishing.
How is this different from other competitor page templates?
It is aimed at developer tools and focuses on honesty, verifiable tables, migration guidance and keeping content current. It is not designed for consumer brands or non-developer products.
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 content writer at a developer tool company who needs a repeatable, honest structure for competitor pages. Pick something else if you sell a non-developer product, or if you need the agent to verify facts or run research tools for you, since this skill only provides written guidance.
Download the skill