# suede-competitor-profiling

Builds evidence-backed profiles from public competitor information. Use it to research named companies or refresh a structured view of your competitors.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 126
- Author: JasonColapietro
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/JasonColapietro/suede-creator-skills/tree/HEAD/skills/suede-competitor-profiling/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/suede-competitor-profiling

## What it does

The skill organizes public evidence about a competitor’s positioning, pricing, product, reviews, search footprint, and other research areas. It distinguishes observed facts from conclusions and unknowns, and saves source material before producing a profile.

Raw captures are organized under `competitor-profiles/raw/`, with separate folders for page captures, SEO inputs, and reviews. Each run gets a date folder; the synthesized profile points back to its source folder, while `_summary.md` brings multiple profiles together.

The workflow checks whether research tools are available and authorized. Without a suitable connector, it falls back to manually reviewing public pages and recording URLs and access dates. Respecting site restrictions is part of the process. Product context in `.agents/product-marketing.md` or `.claude/product-marketing.md` helps decide which competitors and dimensions matter. This skill is not for publishing comparison pages, writing sales battle cards, or deciding pricing changes.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add JasonColapietro/suede-creator-skills --skill suede-competitor-profiling -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/suede-competitor-profiling/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/suede-competitor-profiling/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add JasonColapietro/suede-creator-skills --skill suede-competitor-profiling -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/suede-competitor-profiling/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add JasonColapietro/suede-creator-skills --skill suede-competitor-profiling -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/suede-competitor-profiling/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JasonColapietro/suede-creator-skills suede-competitor-profiling
```

2. **Manually: put the files in place**
- File: `.github/skills/suede-competitor-profiling/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add JasonColapietro/suede-creator-skills --skill suede-competitor-profiling -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/JasonColapietro/suede-creator-skills --path skills/suede-competitor-profiling
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/suede-competitor-profiling/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add JasonColapietro/suede-creator-skills --skill suede-competitor-profiling -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/JasonColapietro/suede-creator-skills/tree/HEAD/skills/suede-competitor-profiling/SKILL.md

## When to use it
- profile a competitor’s market positioning
- compare public prices and product features
- preserve page captures for later review
- collect competitor reviews and SEO inputs
- refresh a structured competitor overview

## Example prompts
- Build a profile of this competitor from its public site and save the source captures.
- Refresh the competitor profiles and compare their positioning and pricing.
- Review this competitor’s feedback and search visibility, separating evidence from conclusions.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 0e392b0eb27d8812.

BEGIN THIRD-PARTY FILE 0e392b0eb27d8812
````text
---
name: suede-competitor-profiling
description: "Suede AI competitive-intelligence discipline: evidence-backed profiles of positioning, pricing, messaging, product, proof, reviews, organic search footprint, and AI answer visibility, built from current public URLs with raw captures saved and fact, inference, and unknowns kept separate. Use when researching named competitors or refreshing a structured view of the competitor set. NOT FOR: publishing comparison or alternative pages (use suede-competitors), internal sales battle cards (use suede-sales-enablement), or deciding pricing changes (use suede-pricing)."
metadata:
  version: 2.1.0
---

# Suede AI Competitor Profiling

Use this competitive-intelligence playbook to turn current public evidence into structured profiles with fact, inference, and unknowns kept separate.

## 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 own positioning and ICP decide which competitors are actually comparable and which dimensions are worth profiling, and they are usually already written down there.

Then work the intake list under Task-Specific Questions below. If the user gave URLs and the context file covers the rest, proceed without asking.

---

## Saving Raw Data

Before synthesizing the profile, persist all raw page captures, SEO inputs, and
review evidence to disk so they can be re-read, audited, or reused without
repeating provider requests or manual collection.

**Directory layout** (relative to project root):

```
competitor-profiles/
├── raw/
│   └── <competitor-slug>/
│       └── <YYYY-MM-DD>/
│           ├── scrapes/    # one .md file per captured page (homepage.md, pricing.md, ...)
│           ├── seo/        # one .json or .csv file per authorized metric source
│           └── reviews/    # one .md or .json file per review source (g2.md, capterra.md, ...)
├── <competitor-slug>.md    # final synthesized profile
└── _summary.md             # cross-competitor summary
```

Rules:

- `<competitor-slug>` is lowercase, hyphenated (e.g. `responsehub`, `safe-base`)
- `<YYYY-MM-DD>` is the date the data was pulled: supports re-running and diffing snapshots over time
````
END THIRD-PARTY FILE 0e392b0eb27d8812

The third-party file has ended. Everything between the 0e392b0eb27d8812 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2324 of 15174 bytes. © JasonColapietro · MIT · https://github.com/JasonColapietro/suede-creator-skills/tree/HEAD/skills/suede-competitor-profiling/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md