# understand-customers

The understand-customers Claude Code skill builds a customer research brief before copywriting begins. It examines customer pain, reasons to switch, objections, and the language people use.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 807 installs · ★ 1797 repo stars
- Author: illyism
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Illyism/seo-skills/tree/HEAD/copywriting/understand-customers/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/understand-customers

## What it does

The skill researches an ideal customer for a product or service before landing-page or ad copy is drafted. Its brief covers the customer’s main frustrations, what might prompt a move to another product, objections, and private doubts. It also explores the outcome they want and the phrases they use to describe the problem.

The research considers past attempts that fell short, their emotional effects, and beliefs tied to the problem. The skill then suggests copy angles, such as emotional hooks or an unexpected turn. It activates for audience research or requests about customer pain points. A short description of the product or service is needed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill understand-customers -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill understand-customers -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill understand-customers -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills copywriting/understand-customers/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/understand-customers/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill understand-customers -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path copywriting/understand-customers
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill understand-customers -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/Illyism/seo-skills/tree/HEAD/copywriting/understand-customers/SKILL.md

## When to use it
- identify customers’ main frustrations
- find reasons they might leave a current product
- surface objections and private doubts
- collect customer language for ad copy

## Example prompts
- Research the audience for my product and outline their main frustrations and objections.
- Explain what could make customers switch from their current solution to my product.
- Suggest ad angles based on what my audience wants and how they describe the problem.

## Similar
- [ad-creative](https://affpapa.org/en/nevibecode/skills/coreyhaines31-ad-creative.md) — skill · 148800 installs
- [ad-copy-variants](https://affpapa.org/en/nevibecode/skills/ad-copy-variants.md) — skill · 26000 installs
- [conversational-ad-copy](https://affpapa.org/en/nevibecode/skills/conversational-ad-copy.md) — skill · 25900 installs
- [ads-copywriter](https://affpapa.org/en/nevibecode/skills/ads-copywriter.md) — skill · 5700 installs
- [ads-create](https://affpapa.org/en/nevibecode/skills/ads-create.md) — skill · 4200 installs
- [ad-creative-builder](https://affpapa.org/en/nevibecode/skills/ad-creative-builder.md) — skill · 1100 installs

From the same set: [illyism/seo-skills](https://affpapa.org/en/nevibecode/by/illyism/seo-skills.md) — 29 cards

---
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
