What is competitor-alternatives?
Creates high-converting 'X vs Y' and 'X alternatives' SEO pages that capture comparison search traffic. Researches competitors, writes honest comparison content, and adds schema markup (FAQPage, ItemList).
MoizIbnYousaf/marketing-cli
Creates high-converting 'X vs Y' and 'X alternatives' SEO pages that capture comparison search traffic. Researches competitors, writes honest comparison content, and adds schema markup (FAQPage, ItemList). Use when someone needs alternatives pages, comparison content, or says 'alternatives page', 'vs page', 'comparison', 'competitor alternatives', 'X vs Y page', or wants to capture competitor brand search traffic with SEO content. Also trigger when someone wants to rank for competitor brand name
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/competitor-alternatives"Quick start
Install it or open the source, trigger it with a clear task, then follow the source workflow.
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/competitor-alternatives"Use competitor-alternatives to help me with: [describe your task]. Before you begin, tell me what input you need, the steps you will follow, and the expected output.
5 key workflow steps, examples, and cautions are distilled below.
Continue to the workflowDirect answers
Creates high-converting 'X vs Y' and 'X alternatives' SEO pages that capture comparison search traffic. Researches competitors, writes honest comparison content, and adds schema markup (FAQPage, ItemList).
It is relevant to workflows involving SEO audit, Engineering, Marketing, Operations.
SkillSignal detected this source-specific command: npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/competitor-alternatives". Inspect the repository and command before running it.
The upstream source does not declare a dedicated Agent platform.
Static analysis detected read-files signals. Review the cited source lines before installing; these signals are not a security audit.
This page combines upstream documentation with deterministic repository, quality, and static-risk signals. It is not described as a manual test or security review.
SkillSignal brief
Creates high-converting 'X vs Y' and 'X alternatives' SEO pages that capture comparison search traffic. Researches competitors, writes honest comparison content, and adds schema markup (FAQPage, ItemList).
Useful in these contexts
Core capabilities
Distilled from the source
About 6 min · 16 sections
People searching "[Competitor] alternatives" or "[Product] vs [Competitor]" have high purchase intent. They already know the category — they're choosing. This skill captures that traffic with structured comparison conte…
Step 1: Identify Comparison Queries
If Web Search Is Unavailable
Step 2: Research Each Competitor
Step 3: Write the Comparison Page
Step 4: Write the Alternatives Roundup
Directory Structure
Frontmatter (VS Pages)
Frontmatter (Alternatives Pages)
Snark destroys credibility. Backhanded compliments ("Competitor is fine if you don't need real features") make you look petty, not confident. Genuine respect for competitors makes your wins land harder — the reader trus…
Unverifiable claims undermine everything. "Our platform is 10x faster" without benchmarks reads as marketing fluff. Readers researching alternatives are already skeptical — every claim needs evidence (benchmark, case st…
Acknowledging competitor strengths builds trust. Readers know competitors aren't terrible — they're actively considering them. Trying to make competitors look bad makes your content look biased. Honest acknowledgment is…
Stale pricing erodes trust instantly. If a reader checks and your pricing is wrong, they'll question everything else on the page. When you can't verify current pricing, say "as of {date}" and note it may have changed —…
Quality breakdown
Based on traceable docs and repository signals; stars are not treated as quality.
Compare before choosing
These links are selected from shared tasks, functions, stacks, platforms, and same-name variants. Compare the source owner, documentation, permissions, and maintenance signals.
Backlink + distribution checklist that expands a site's KD ceiling beyond what on-page work alone can earn. Use when the user mentions 'backlinks', 'off-page SEO', 'directory submissions', 'guest posts', 'outreach targets', 'link building', 'submit to directories', 'get listed in listicles', 'Product Hunt launch backlinks', or asks 'how do I get more domain authority'. Generates a prioritized, researched target list across directories, listicles, and guest-post candidates — does NOT submit anyth
Use this skill when the user asks to analyze, tear down, or reverse-engineer a competitor's paid ads. Trigger for prompts like "what ads is [competitor] running", "tear down their ad strategy", "competitor ad analysis", "find ad angles we haven't tried", or "reverse-engineer their paid funnel". Do not trigger for organic/SEO competitor research or website positioning analysis.
Umbrella workflow for 67 public skills: Full Send, copy, design, code review, SEO, launch packaging, MCP QA, iOS and Android app shipping, and creator workflows. Loads the full public skill pack.
Plans free tools, calculators, generators, and interactive widgets that attract target audience through search and social sharing. Engineering as marketing — build something useful, capture leads. Use when someone wants to build a free tool for marketing, says 'free tool', 'calculator', 'generator', 'engineering as marketing', 'side project marketing', 'interactive widget', 'lead generation tool', 'SEO tool', 'growth hack', 'build something to attract users', or wants to attract users through ut
Build an organic-traffic operating system for any site or app: a multi-phase, resumable engine that ships programmatic landing pages (alternatives, comparisons, use-cases, playbooks) on top of real keyword research. Use when the user says 'SEO machine', 'build organic traffic', 'rank on Google', 'we need traffic', 'alternatives pages', 'comparison pages', '/for/ pages', 'programmatic SEO', or 'build an SEO engine'. Distinct from `seo-audit` (one-off diagnostic) and `seo-content` (single-article
People searching "[Competitor] alternatives" or "[Product] vs [Competitor]" have high purchase intent. They already know the category — they're choosing. This skill captures that traffic with structured comparison content that ranks and converts.
brand/ directory: load competitors.md, positioning.md, voice-profile.md, audience.md if present.Prefer OpenSEO find_serp_competitors / get_serp_results and openseo-competitor-analysis findings when configured; otherwise Exa SERP scrape with overlap unknown. Full contract: skills/openseo/references/backend-contract.md.
Brand context loaded:
├── Competitors ✓/✗ ({N} competitors profiled)
├── Positioning ✓/✗ ("{primary angle}")
├── Voice Profile ✓/✗
└── Audience ✓/✗
competitors.md is missing: suggest running /competitive-intel first, or ask user to provide competitor names, pricing, and key differentiators.positioning.md is missing: ask for the product's primary value prop and target audience.brand/landscape.md if it exists — check the Claims Blacklist before making ecosystem or competitive claims. If stale (>14 days) or missing, warn that market claims may be outdated.brand/competitors.md — Known competitors, their positioning, pricing, weaknessesbrand/positioning.md — Your product's unique value props, differentiators, target audiencebrand/voice-profile.md — Tone for comparison copybrand/audience.md — Who is choosing between you and competitorscompetitive-intel — Should have competitor research completed first (not hard-blocked — can proceed with user-provided data)Pull from competitors.md and generate the full keyword set:
[competitor] alternatives (highest volume)[competitor] vs [your product] (branded)[your product] vs [competitor] (branded reverse)best [category] tools (category)[competitor] review (review intent)[competitor] pricing (price-sensitive)Prioritize by: search volume estimate > purchase intent > your win rate against that competitor.
Use data from brand/competitors.md if it exists. Ask the user directly for: competitor pricing, key strengths/weaknesses, and notable reviews or complaints they've seen. Note limitation: 'Competitor data is based on provided context, not live research. Verify current pricing and features before publishing.'
For each competitor page, gather:
Structure for each page:
---
title: "[Competitor] vs [Your Product]: Honest Comparison [Year]"
description: "Comparing [Competitor] and [Your Product] on features, pricing, and ease of use. See which is right for your needs."
slug: /compare/[competitor]-vs-[your-product]
schema: ComparisonPage
---
## TL;DR
[2-3 sentence verdict. Be specific about WHO should pick which tool.]
## Quick Comparison
| Feature | [Your Product] | [Competitor] |
|---------|---------------|--------------|
| [Feature 1] | [Status/Detail] | [Status/Detail] |
| [Feature 2] | [Status/Detail] | [Status/Detail] |
| Pricing starts at | $X/mo | $Y/mo |
| Free tier | Yes/No | Yes/No |
| Best for | [Audience] | [Audience] |
## [Your Product] Overview
[2-3 paragraphs. Lead with your strongest differentiator against THIS specific competitor.]
## [Competitor] Overview
[2-3 paragraphs. Fair and accurate. Acknowledge their strengths.]
## Feature-by-Feature Breakdown
### [Category 1]
[Detailed comparison with specifics, not vague claims]
### [Category 2]
[Same pattern]
## Pricing Comparison
[Side-by-side pricing breakdown. Include hidden costs, overage fees, feature gates.]
## Verdict: Which Should You Choose?
**Choose [Your Product] if:**
- [Specific use case 1]
- [Specific use case 2]
- [Specific use case 3]
**Choose [Competitor] if:** (**REQUIRED — 3 honest tradeoffs minimum**)
- [Specific use case where they genuinely win — cite the feature, not a vague claim]
- [Another honest scenario — name the situation concretely]
- [A third where they're objectively better — pricing tier, integration, niche capability]
> **Honesty section is non-negotiable.** Three concrete, verifiable scenarios where the competitor wins. This is the section that earns the reader's trust — and the section AI Overviews and ChatGPT cite when picking which comparison page to surface. Pages without it underperform measurably on both ranking AND conversion. "We're better at everything" reads as marketing copy; "they're better at X, Y, Z but we're better at A, B, C" reads as a real comparison.
## Ready to try [Your Product]?
[CTA — free trial, demo, or signup. Match to the comparison context.]
For the "[Your Product] alternatives" defensive page and "[Competitor] alternatives" offensive pages:
---
title: "Best [Competitor] Alternatives [Year]"
description: "Looking for [Competitor] alternatives? Compare the top X options including pricing, features, and who each is best for."
slug: /compare/[competitor]-alternatives
schema: ItemList
---
## Why People Switch from [Competitor]
[3-5 common reasons based on review mining — pricing, missing features, UX friction]
## Best [Competitor] Alternatives
### 1. [Your Product] — Best for [specific use case]
**Pricing:** ...
**Key difference:** ...
**Best for:** ...
### 2. [Alternative 2] — Best for [different use case]
[Same structure]
### 3-5. [More alternatives]
[Same structure, be genuinely helpful]
## Comparison Table
[Full matrix of all alternatives]
## How to Choose
[Decision framework based on use case, team size, budget]
Add JSON-LD schema to each page:
FAQPage schema with common comparison questionsItemList schema for the roundupArticle schema with author, date, modified dateUse these to write honest, credible verdicts:
The Acknowledger: "While [Competitor] excels at [X], [Your Product] is purpose-built for [Y] — which matters more if you're [target use case]."
The Segmenter: "[Competitor] is the right choice for [persona A]. But if you're [persona B], [Your Product] will save you [specific outcome]."
The Switcher: "If you're already using [Competitor] and frustrated by [common complaint], [Your Product] solves that with [specific feature]."
For clear wins: "Start your free trial — most teams switch from [Competitor] in under an hour."
For close comparisons: "Not sure yet? Try both free tiers and compare with your actual workflow."
For price-sensitive: "Get [Competitor]-level features at [fraction] of the cost. See pricing."
Each comparison generates:
./campaigns/comparisons/
├── vs/
│ ├── {competitor-slug}-vs-{your-product-slug}.md
│ └── ...
├── alternatives/
│ ├── {competitor-slug}-alternatives.md
│ └── {your-product-slug}-alternatives.md (defensive)
└── index.md (comparison hub page)
---
title: "{Competitor} vs {Your Product}: Honest Comparison {Year}"
meta_description: "{150-160 chars}"
slug: /compare/{competitor}-vs-{your-product}
page_type: comparison
competitor: "{Competitor Name}"
date_created: "{YYYY-MM-DD}"
last_updated: "{YYYY-MM-DD}"
status: "draft"
schema_faq: |
{FAQPage JSON-LD}
schema_article: |
{Article JSON-LD}
---
---
title: "Best {Competitor} Alternatives {Year}"
meta_description: "{150-160 chars}"
slug: /compare/{competitor}-alternatives
page_type: alternatives
competitor: "{Competitor Name}"
alternatives_count: {number}
date_created: "{YYYY-MM-DD}"
last_updated: "{YYYY-MM-DD}"
status: "draft"
schema_itemlist: |
{ItemList JSON-LD}
schema_article: |
{Article JSON-LD}
---
/competitive-intel first for thorough research. Can proceed with user-provided data.After saving, suggest:
/competitive-intel — deepen research on specific competitors/seo-content — create supporting content (e.g., "[category] buyer's guide")/page-cro — optimize comparison pages for conversion/content-atomizer — distribute comparison insights across social channels