understand-customers — Claude Code skill for customer research
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.
no license 807 installs ★ 1,797 updated 2026-11-16
npx skills add Illyism/seo-skills --skill understand-customers -a claude-codeWhat understand-customers 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.
What it helps with
- 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 for the agent
- 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.
How to install understand-customers
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill understand-customers -a claude-code2Manually: put the files in place
~/.claude/skills/understand-customers/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/understand-customers/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill understand-customers -a codex2Manually: put the files in place
.agents/skills/understand-customers/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill understand-customers -a cursor2Manually: put the files in place
.cursor/skills/understand-customers/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills copywriting/understand-customers/SKILL.md2Manually: put the files in place
.github/skills/understand-customers/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill understand-customers -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path copywriting/understand-customersManually: put the files in place
.devin/skills/understand-customers/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill understand-customers -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about understand-customers
How do I install understand-customers in Claude Code?
Run npx skills add Illyism/seo-skills --skill understand-customers -a claude-code. The skill file is at ~/.claude/skills/understand-customers/SKILL.md.
What does understand-customers do?
It creates a research brief about an ideal customer, covering their frustrations, objections, reasons to switch, and choice of words. It then proposes directions for ad copy.
When does understand-customers run?
Ask for ideal-customer research before drafting landing-page or ad copy, or ask the agent to investigate customer pain points.