Skip to content
cccskills
FreePublished on GitHub

suede-competitors

Suede AI comparison-page discipline for accurate, evidence-backed alternative, versus, and competitor-comparison content that wins evaluators and search intent. Use when planning or writing a public page that positions products against named alternatives from verified evidence. NOT FOR: gathering the underlying competitor evidence (use suede-competitor-profiling), internal battle cards (use suede-sales-enablement), or scaled page generation (use suede-programmatic-seo).

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (6)

  • SKILL.md12.0 KB
  • agents/openai.yaml526 B
  • CARD.md4.4 KB
  • evals/evals.json6.5 KB
  • references/content-architecture.md7.7 KB
  • references/templates.md5.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Suede Competitor and Alternative Pages

Use this Suede comparison-page playbook to serve competitive search intent while keeping every product claim current, sourced, and fair.

Initial Assessment

Check for .agents/product-marketing.md (or .claude/product-marketing.md, or the legacy product-marketing-context.md) and read it if present: your value proposition, ICP, pricing model, differentiators, and proof decide which comparisons you can win on the evidence, and they are usually already written down there.

Then work the intake list under Task-Specific Questions below; ask only what the context file did not already answer. Current competitor evidence, pricing, features, ratings, comes from suede-competitor-profiling, not from memory.


Page Formats

Format 1: [Competitor] Alternative (Singular)

Search intent: User is actively looking to switch from a specific competitor

URL pattern: /alternatives/[competitor] or /[competitor]-alternative

Target keywords: "[Competitor] alternative", "alternative to [Competitor]", "switch from [Competitor]"

Page structure:

  1. Why people look for alternatives (validate their pain)
  2. Summary: You as the alternative (quick positioning)
  3. Detailed comparison (features, service, pricing)
  4. Who switches, and what they gain
  5. Migration path
  6. Social proof from switchers
  7. CTA

Format 2: [Competitor] Alternatives (Plural)

Search intent: User is researching options, earlier in journey

URL pattern: /alternatives/[competitor]-alternatives

Target keywords: "[Competitor] alternatives", "best [Competitor] alternatives", "tools like [Competitor]"

Page structure:

  1. Why people look for alternatives (common pain points)
  2. What to look for in an alternative (criteria framework)
  3. List of alternatives (you first, but include real options)
  4. Comparison table (summary)
  5. Detailed breakdown of each alternative
  6. Recommendation by use case
  7. CTA

Important: Include 4-7 real alternatives. Being genuinely helpful builds trust and ranks better.

AI-answer expectations by stage: these pages can earn citations in AI answers, but whether AI recommends your brand from them also depends on offsite consensus (reviews, forums, analysts). For emerging brands, a self-ranked list may surface competitors while the brand receives only a citation. Treat that as a hypothesis and test it on the suede-ai-seo prompt panel before building more.


Format 3: You vs [Competitor]

Search intent: User is directly comparing you to a specific competitor

URL pattern: /vs/[competitor] or /compare/[you]-vs-[competitor]

Target keywords: "[You] vs [Competitor]", "[Competitor] vs [You]"

Page structure:

  1. TL;DR summary (key differences in 2-3 sentences)
  2. At-a-glance comparison table
  3. Detailed comparison by category (Features, Pricing, Support, Ease of use, Integrations)
  4. Who [You] is best for
  5. What customers say (testimonials from switchers)
  6. Migration support
  7. CTA

Format 4: [Competitor A] vs [Competitor B]

Search intent: User comparing two competitors (not you directly)

URL pattern: /compare/[competitor-a]-vs-[competitor-b]

Page structure:

  1. Overview of both products
  2. Comparison by category
  3. Who each is best for
  4. The third option (introduce yourself)
  5. Comparison table (all three)
  6. CTA

Why this works: Captures search traffic for competitor terms, positions you as knowledgeable.


Cliches to Refuse

A comparison page written on autopilot arrives with these already in it. Each one tells an evaluator the page is marketing, not research, refuse them by name:

  • The strawman competitor. A weakness stated as caricature ("clunky", "built for 2015") rather than a specific, sourced limitation a user would actually hit.
  • A "Winner" row. No verdict row, no trophy, no score-out-of-10 that resolves to you. The reader decides; the page supplies evidence.
  • Vague superiority. "Better in every way" or "the obvious choice" with nothing behind it. Every advantage names the specific capability, the reader it serves, and its source.
  • A table built on dimensions nobody shops on. Pick the rows the reader's decision actually turns on (price, the job to be done, integrations, migration effort) and fill every cell with a sourced fact, so the advantages you show are ones the reader cares about.

For the two remaining defaults, the ✓/✗ feature table and a migration section with no real friction, use the concrete before/after in references/templates.md: "Comparison Table Best Practices" and "Migration Section".


Essential Sections

TL;DR Summary

Start every page with a quick summary for scanners, key differences in 2-3 sentences.

Paragraph Comparisons

Go beyond tables. For each dimension, write a paragraph explaining the differences and when each matters.

Feature Comparison

For each category: describe how each handles it, cite the competitor's documented limitations with sources, and state the specific advantage your product delivers.

Pricing Comparison

Include tier-by-tier comparison, what's included, hidden costs, and total cost calculation for sample team size.

Who It's For

Name the reader your product is built for and the outcome they get: the use case, the team, the workflow, and the result. Specific beats broad, and a sourced outcome beats an adjective.

Keep material facts in plain view where they decide the purchase: price, plan limits, platform requirements, and migration effort. State them directly in the pricing, FAQ, and migration sections rather than as caveats on the pitch.

Migration Section

Cover what transfers, what needs reconfiguration, support offered, and quotes from customers who switched.

For detailed templates: See references/templates.md


Content Architecture

Centralized Competitor Data

Create a single source of truth for each competitor with:

  • Positioning and target audience
  • Pricing (all tiers)
  • Feature ratings
  • Strengths and weaknesses
  • Best for / not ideal for
  • Common complaints (from reviews)
  • Migration notes

For data structure and examples: See references/content-architecture.md


Research Process

Deep Competitor Research

For each competitor, gather:

  1. Product research: Sign up, use it, document features/UX/limitations
  2. Pricing research: Current pricing, what's included, hidden costs
  3. Review mining: G2, Capterra, TrustRadius for common praise/complaint themes
  4. Customer feedback: Talk to customers who switched (both directions)
  5. Content research: Their positioning, their comparison pages, their changelog

Ongoing Updates

  • Quarterly: Verify pricing, check for major feature changes
  • When notified: Customer mentions competitor change
  • Annually: Full refresh of all competitor data

SEO Considerations

Keyword Targeting

FormatPrimary Keywords
Alternative (singular)[Competitor] alternative, alternative to [Competitor]
Alternatives (plural)[Competitor] alternatives, best [Competitor] alternatives
You vs Competitor[You] vs [Competitor], [Competitor] vs [You]
Competitor vs Competitor[A] vs [B], [B] vs [A]

Internal Linking

  • Link between related competitor pages
  • Link from feature pages to relevant comparisons
  • Create hub page linking to all competitor content

Answer-Engine Readiness

"[X] vs [Y]" and "[X] alternatives" are among the prompts buyers put to ChatGPT, Perplexity, Copilot, and AI Overviews, and comparison pages are a common source for those answers. Build every page so a passage can be lifted accurately:

  • The TL;DR answers the comparison in the first 40 to 80 words and names both products.
  • Section headings are the questions buyers ask ("Is [You] cheaper than [Competitor] for a 10-person team?").
  • The comparison is a real <table>, every cell sourced and dated.
  • Product and company names match each vendor's canonical spelling.
  • A visible "last checked" date reflects the actual claim review.

Schema Markup

Article markup with author, datePublished, and dateModified that match the visible byline and dates; BreadcrumbList when a breadcrumb is shown. FAQPage markup no longer produces Google rich results (ended May 2026); use it only to mirror a visible FAQ. Never mark up a competitor's ratings or reviews as your own.

KPIs

Impressions and clicks for the page's query family (Search Console), citation and recommendation share on the matching prompt cluster (suede-ai-seo), assisted sign-ups or demos from the page (analytics), and the claim-review date, which should never be older than a quarter.


Before You Hand It Over

Boundaries below requires a final claim review before any comparison page ships. This is that review, run it as a second pass over the finished draft, not while drafting:

  1. Re-read every claim about a competitor: pricing, tier contents, feature availability, ratings, review counts, testimonials, headcount, funding.
  2. Each one carries a source URL and the date you checked it. A claim without both is cut, or explicitly marked unverified in the page: never softened into hedged prose ("reportedly", "many users find", "known for"). Hedging an unsourced claim keeps the claim and loses the accountability.
  3. Anything sourced more than a quarter ago gets re-checked before publication, not carried forward. Pricing pages move.
  4. Claims about your own live visibility or how AI answers cite the page are not verifiable from here; measure them with the suede-ai-seo prompt panel.

Output Format

Three deliverables, all with their schemas in the references: do not invent a shape for them:

  • Competitor data file: the centralized per-competitor record; structure in references/content-architecture.md.
  • Page content: URL, meta tags, full copy by section, tables, CTAs; section templates in references/templates.md.
  • Page set plan: which pages to create, in priority order by search volume and evidence readiness.

Task-Specific Questions

  1. What are common reasons people switch to you?
  2. Do you have customer quotes about switching?
  3. What's your pricing vs. competitors?
  4. Do you offer migration support?

Boundaries

  • Do not invent, cherry-pick, or present stale competitor claims, prices, features, testimonials, or rankings as current fact.
  • Do not publish, deploy, index, or update comparison pages without explicit authorization and a final claim review.
  • Do not use competitor trademarks in a way that implies affiliation or reuse protected creative assets without rights.
  • Do not claim universal superiority; tie each advantage to its audience, criteria, source, and checked date.

Routing

  • Need current competitor evidence -> use suede-competitor-profiling.
  • Need review-mining or forum synthesis for the "common complaints" and switching-reason sections -> use suede-customer-research.
  • Need scaled comparison-page architecture -> use suede-programmatic-seo.
  • Need final page copy or organic QA -> use suede-copy or suede-seo-audit.
  • Need to know whether answer engines cite or recommend the page -> use suede-ai-seo.
  • Need internal battle cards -> use suede-sales-enablement.
  • From those skills, route evidence-backed public alternative and versus-page composition back to suede-competitors.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Suede AI Android app factory: plan, build, test, and prepare a production native Android app from product idea to a Play-ready signed bundle. Use for requests to create, ship, monetize, or modernize an Android app. Covers Kotlin and Jetpack Compose architecture, live target-API and Play policy checks, 16 KB page sizes, accessibility, privacy and Data Safety, Play Billing Library 8+, Play Integrity, account deletion, kids and Families rules, testing, performance, store assets, signing, and a release evidence gate. NOT FOR: uploading, promoting, or rolling out a build on Play (use suede-play-release); turning a website into an iOS app (use site-to-ios-app); a review-only pass on an existing app (use suede-code --findings-only); Play listing, keyword, and screenshot strategy (use suede-aso).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Design, review, and visually QA web and app interfaces against explicit design laws so shipped screens look intentional instead of generic AI output.

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI workflow for turning a live website, PWA, dashboard, or marketplace into an iOS app. Use when the user has a site or web app and asks to put it on the App Store, wrap it in an app, ship an iOS version, or convert a PWA to native. Produces SITE_TO_IOS_AUDIT.md and SITE_TO_IOS_PLAN.md: URL audit, shell-vs-native strategy, App Store Guideline 4.2 wrapper risk and the native value that mitigates it, current SDK, privacy manifest, age rating, login and payment checks, kids-app rules, QA matrix, and a release gate. NOT FOR: Android builds or conversions (use android-app-factory); Google Play uploads and rollouts (use suede-play-release); App Store listing, keyword, and screenshot strategy (use suede-aso).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI experimentation discipline: hypotheses, sample size and power, test duration, guardrail metrics, significance and readouts, sequential designs, and an ICE-ranked experiment backlog with a reusable playbook. Use when comparing variants, deciding whether a result is reliable, or building an experiment program and cadence. NOT FOR: analytics instrumentation (use suede-analytics), post-click conversion diagnosis (use suede-site-alchemy), writing the variant copy (use suede-copy), or channel-level incrementality and geo holdouts (use suede-attribution).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI paid-media creative system: angles, hooks, headlines, primary text, RSA and Performance Max assets, static and motion concepts, iOS-native reveal videos, grounded batch production, client review pages, and iteration from performance data, all checked against platform character limits. Use when producing or iterating ad creative for Google, Meta, LinkedIn, TikTok, or X from real product, review, and performance inputs. NOT FOR: campaign budgets, bidding, or targeting (use suede-ads), statistical test design (use suede-ab-testing), organic social posts (use suede-social), general marketing images such as OG or hero graphics (use suede-image), or landing-page copy (use suede-copy).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

Suede AI paid-acquisition operating system for channel choice, campaign structure, audiences, bidding, budget pacing, negative keywords, retargeting, B2B and ABM playbooks, and kill-or-scale decisions, with platform facts checked in October 2026 (Meta Andromeda and attribution windows, Performance Max controls). Use when planning, auditing, or optimizing paid campaigns on Google, Meta, LinkedIn, X, TikTok, or comparable platforms. NOT FOR: producing ad copy or creative variants (use suede-ad-creative), implementing tracking (use suede-analytics), attribution models or reconciliation (use suede-attribution), or the landing page (use suede-site-alchemy).

The English summary is being prepared. Showing the original description.

JasonColapietro/suede-creator-skills125Updated Oct 24, 2026

See all skills by JasonColapietro

Report a problem with this skill