# customer-journey

customer-journey — a Claude Code skill that maps customer discovery and evaluation across search and AI chatbots using a five-stage awareness journey. Runs when queries ask about search intent, buyer journeys, or content strategy.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 831 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/marketing/customer-journey/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/customer-journey

## What it does

The skill analyzes brand context, screenshots, or keywords and evaluates behavioral search intent across traditional search engines, social platforms, and conversational AI tools. By default, the analysis assumes a B2B SaaS context and combines web search with the five-stage awareness journey framework. For each stage, the agent outputs user mindsets, natural chatbot prompts, and content strategy recommendations in clean markdown.

The agent triggers this skill when requests mention search intent, AI SEO prompts, discoverability, or awareness stages. The process covers context analysis, light web research, and structured stage breakdowns with clear headings.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills marketing/customer-journey/SKILL.md
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path marketing/customer-journey
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill customer-journey -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/marketing/customer-journey/SKILL.md

## When to use it
- map the customer journey for a website
- analyze behavioral search intent
- generate content strategy by funnel stage
- create natural prompts for AI chatbots

## Example prompts
- Map the customer journey for our SaaS product
- What prompts do users type at the problem-aware stage
- Analyze search intent and build a five-stage awareness journey

## Similar
- [customer-journey-map](https://affpapa.org/en/nevibecode/skills/customer-journey-map.md) — skill · 3300 installs
- [customer-journey-mapper](https://affpapa.org/en/nevibecode/skills/customer-journey-mapper.md) — skill · 257 installs
- [customer-journey-orchestration](https://affpapa.org/en/nevibecode/plugins/customer-journey-orchestration.md) — plugin · ★ 450 repo stars
- [customer-journey-mapping-workshop](https://affpapa.org/en/nevibecode/skills/customer-journey-mapping-workshop.md) — skill · 2800 installs
- [optimize-for-ai](https://affpapa.org/en/nevibecode/skills/optimize-for-ai.md) — skill · 6600 installs
- [suede-ai-seo](https://affpapa.org/en/nevibecode/skills/suede-ai-seo.md) — skill · ★ 121 repo stars

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
