Agent skill

Suede Competitors

by JasonColapietro in JasonColapietro/suede-creator-skills

Suede-owned comparison-page discipline for accurate, evidence-backed alternative, versus, and competitor-comparison content that wins evaluators and search intent.

MITAuto-check passedMarketing & SEO

Install Suede Competitors

skills CLI
$ npx skills add JasonColapietro/suede-creator-skills --skill suede-competitors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JasonColapietro/suede-creator-skills suede-competitors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JasonColapietro/suede-creator-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/suede-competitors .claude/skills/suede-competitors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
suede-competitors
GitHub stars
127
Token cost
~2.7k tokens
SKILL.md length
1,360 words
Files
6 (incl. references)
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Suede-owned comparison-page discipline for accurate, evidence-backed alternative, versus, and competitor-comparison content that wins evaluators and search intent.

  • Works in 7 steps: Why people look for alternatives… → Summary: You as the alternative (quick… → Detailed comparison (features, service,… → …
  • Writing a public page that positions products against named alternatives from verified evidence
  • SKILL.md covers Initial Assessment, Page Formats, Cliches to Refuse and Essential Sections, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Suede Competitors is an agent skill from JasonColapietro/suede-creator-skills. Suede-owned 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).

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `CARD.md`, `agents/openai.yaml` and `evals/evals.json`).

It sits in Marketing & SEO, covering Programmatic SEO, Competitor analysis and Keyword research. The repository describes itself as: Open-source AI skills for SEO, AI search visibility, conversion copy, marketing strategy, and business operations. Reusable workflows for Claude Code and Codex, plus code review… The licence is MIT.

When your agent uses it

  • Writing a public page that positions products against named alternatives from verified evidence
  • Tasks that involve Programmatic SEO
  • Tasks that involve Competitor analysis

Example prompts

  • “/suede-competitors”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit e5f94d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Suede Competitors loads about 2.7k tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 124 tokens; SKILL.md has 1,360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JasonColapietro/suede-creator-skills at commit e5f94d7, republished under its MIT licence (© JasonColapietro). 1,360 words, ~2,740 tokens.

Download SKILL.mdSave it as .claude/skills/suede-competitors/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
suede-competitors
description
Suede-owned 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).
metadata.version
2.0.1

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 route current visibility evidence and claim validation to suede-seo-audit.


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

Show full SKILL.md (557 more words)Show less
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
Schema Markup

Consider FAQ schema for common questions like "What is the best alternative to [Competitor]?"


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, route those to suede-seo-audit.

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 internal battle cards -> use suede-sales-enablement.
  • From those skills, route evidence-backed public alternative and versus-page composition back to suede-competitors.

© JasonColapietro, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/suede-competitors of JasonColapietro/suede-creator-skills.

  • SKILL.md
  • CARD.md
  • agents/openai.yaml
  • evals/evals.json
  • references/content-architecture.md
  • references/templates.md

Open the folder on GitHubat commit e5f94d7

Compare with similar skills

Suede Competitors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Suede Competitors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Suede Competitors this skillJasonColapietro/suede-creator-skills127—~2.7kAutomated safety check: PassMIT
Competitor Alternativesfreekmurze/dotfiles1k24 repos~2kAutomated safety check: PassNone
Competitor Alternativesalirezarezvani/claude-skills28k1 repos~2.8kAutomated safety check: PassMIT
Competitorscoreyhaines31/marketingskills54k—~3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
SEO DataforseoAgriciDaniel/codex-seo7992 repos~4.6kAutomated safety check: PassMIT

Similar skills

  • Competitor Alternatives

    freekmurze/dotfiles

    When the user wants to create competitor comparison or alternative pages for SEO and sales enablement.

    1k GitHub starsUsed in 24 repos~2k tokens
    Marketing & SEOAuto-check passed
  • Competitor Alternatives

    alirezarezvani/claude-skills

    When the user wants to create competitor comparison or alternative pages for SEO and sales enablement.

    28k GitHub starsUsed in 1 repo~2.8k tokens
    Marketing & SEOAuto-check passed
  • Competitors

    coreyhaines31/marketingskills

    When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use.

    54k GitHub stars~3k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Marketing & SEOAuto-check passed
  • Competitor Profiling

    Nexus-JPF/note-companion

    When the user wants to research, profile, or analyze competitors from their URLs.

    870 GitHub starsUsed in 4 repos~3.5k tokens
    Marketing & SEOAuto-check passed

More from JasonColapietro/suede-creator-skills

All 78 skills in this repo
  • Suede Release Linter

    JasonColapietro/suede-creator-skills

    Lints a local music or media release folder and scores its readiness, flagging missing files, weak metadata, artwork and stem problems, split gaps and rights blockers.

    127 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check: notes
  • Creator Rights Passport

    JasonColapietro/suede-creator-skills

    Turns messy creator materials into an offline rights-and-provenance transfer package: hashed asset inventory, intake manifest, credits, license notes and a missing-information report.

    127 GitHub stars~3.7k tokensUpdated yesterday
    Auto-check: notes
  • Suede Clip to Guide

    JasonColapietro/suede-creator-skills

    Turns a video clip, interview moment or transcript into a package that bridges viewers to a long-form guide, with rights, claim and approval gates along the way.

    127 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed
  • Suede MCP Release QA

    JasonColapietro/suede-creator-skills

    Checks a Suede AI MCP server release against a live process: the full JSON-RPC lifecycle, schemas, annotations, malformed input, catalog agreement and install docs.

    127 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Android App Factory

    JasonColapietro/suede-creator-skills

    Takes a native Android app from product idea to Google Play release, covering Compose architecture, policy checks, privacy, billing, testing, signing and rollout.

    127 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Suede Ad Creative

    JasonColapietro/suede-creator-skills

    Suede-owned paid-media creative system for hooks, headlines, primary text, static and motion concepts, platform specs, review pages, and test-ready variant batches.

    127 GitHub stars~5k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Suede Competitors

What does Suede Competitors do?

Suede-owned comparison-page discipline for accurate, evidence-backed alternative, versus, and competitor-comparison content that wins evaluators and search intent. Suede Competitors is an agent skill from JasonColapietro/suede-creator-skills. Suede-owned comparison-page discipline for accurate, evidence-backed alternative, versus, and competitor-comparison content that wins evaluators and search intent.

When should I use Suede Competitors?

Suede Competitors fits situations like: writing a public page that positions products against named alternatives from verified evidence; tasks that involve Programmatic SEO; tasks that involve Competitor analysis.

How do I install Suede Competitors in Claude Code?

Run `npx skills add JasonColapietro/suede-creator-skills --skill suede-competitors -a claude-code`. Or copy the skill folder (skills/suede-competitors in JasonColapietro/suede-creator-skills) into .claude/skills/suede-competitors in your project. Claude Code loads it when a task matches its description.

How do I install Suede Competitors in Codex?

Run `npx skills add JasonColapietro/suede-creator-skills --skill suede-competitors -a codex`. Or copy the skill folder (skills/suede-competitors in JasonColapietro/suede-creator-skills) into .agents/skills/suede-competitors in your project. Codex loads it when a task matches its description.

Can I use Suede Competitors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JasonColapietro/suede-creator-skills --skill suede-competitors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/suede-competitors, .gemini/skills/suede-competitors, .github/skills/suede-competitors and .opencode/skills/suede-competitors in your project.

What does Suede Competitors need to run?

SKILL.md names no scripts, command-line tools or credentials: Suede Competitors is instructions for the agent only.

Does Suede Competitors access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Suede Competitors safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Suede Competitors use?

Suede Competitors is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Suede Competitors use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Suede Competitors?

Skills that share tags, products or a category with Suede Competitors: Competitor Alternatives (freekmurze/dotfiles, 1k stars), Competitor Alternatives (alirezarezvani/claude-skills, 28k stars), Competitors (coreyhaines31/marketingskills, 54k stars) and SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Suede Competitors?

JasonColapietro (a GitHub user) maintains it in JasonColapietro/suede-creator-skills, which has 127 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 10, 2026.

Source: JasonColapietro/suede-creator-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.