Skip to main content
skill CX Codex

customer-persona-builder — Claude Code skill: what it does

customer-persona-builder builds ICPs, buyer personas and user archetypes from templates, with a weighted scoring matrix and interview questions behind them.

MIT 149 installs ★ 114 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill customer-persona-builder -a claude-code
Open on GitHub

What customer-persona-builder does

The skill keeps three portraits apart: an ICP covers the company, a buyer persona covers whoever holds the budget, a user persona covers the person who touches the product daily. Mixing them up wrecks targeting and roadmaps, so that split comes first.

You get an ICP template with firmographics and technographics, plus a scoring matrix weighted by industry, company size, pain intensity and budget. Accounts landing at 4.0-5.0 go to Tier 1; anything under 2.0 is disqualified. The buyer persona document holds goals, pains with their impact, decision criteria, objections traced to a root cause, and messaging lines. Tables list research methods with sample sizes and timelines, and a question bank sits ready for interviews.

Nothing in the skill gathers data for you. It supplies the frame and the questions; customer conversations, CRM exports and win/loss reviews stay your job. Fill a template without 10-20 interviews per persona and most fields stay blank.

What it helps with

  • build an ICP from firmographics and current tech stack
  • separate buyer personas from user personas
  • score accounts against weighted criteria and drop bad fits
  • draft interview questions for customer research
  • trace objections back to their root cause

Example prompts for the agent

  • Build an ICP for our product: vertical, company size, stack, budget authority.
  • Turn the notes in interviews/ into a buyer persona for a marketing lead.
  • Score the accounts in accounts.csv with the matrix and show which ones reach Tier 1.

How to install customer-persona-builder

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill customer-persona-builder -a claude-code

2Manually: put the files in place

~/.claude/skills/customer-persona-builder/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/customer-persona-builder/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about customer-persona-builder

How do I install customer-persona-builder in Claude Code?

Run npx skills add travisjneuman/.claude --skill customer-persona-builder -a claude-code. The skill lands at ~/.claude/skills/customer-persona-builder/SKILL.md.

What does customer-persona-builder do?

It provides a structure for ICPs, buyer personas and user personas: field templates, an account scoring matrix and an interview question bank.

What is the difference between an ICP and a buyer persona?

An ICP describes a company: industry, size, revenue, tech stack. A buyer persona describes one person with goals, objections and ranked decision criteria. A single ICP usually contains several buyer personas, and they are not always the people who use the product.

Source text

SKILL.md · MIT
---
name: customer-persona-builder
description: Data-driven customer persona development combining market research, user behavior analysis, and segmentation frameworks. Use when creating buyer personas, ideal customer profiles (ICPs), or user archetypes.
---

# Customer Persona Builder

Structured frameworks for creating data-driven customer personas, ideal customer profiles, and user archetypes.

## Persona vs ICP Distinction

### When to Use Which

```
IDEAL CUSTOMER PROFILE (ICP):
- Company-level / account-level description
- Used by: Sales, marketing (targeting), product (roadmap)
- Answers: "What companies should we sell to?"
- Firmographic: industry, size, revenue, tech stack

BUYER PERSONA:
- Individual-level description
- Used by: Sales (conversations), marketing (messaging), content
- Answers: "Who are the people making buying decisions?"
- Behavioral: goals, pain points, decision process

USER PERSONA:
- End-user description (may differ from buyer)
- Used by: Product, design, engineering
- Answers: "Who uses the product daily?"
- Task-based: workflows, jobs-to-be-done, frustrations

RELATIONSHIP:
ICP (company) contains multiple Buyer Personas (people)
who may differ from User Personas (daily users).
```

## Ideal Customer Profile Template

### ICP Framework

```
IDEAL CUSTOMER PROFILE:

FIRMOGRAPHICS:
- Industry:        [specific verticals]
- Company Size:    [employee range]
- Annual Revenue:  [revenue range]
- Geography:       [regions/countries]
- Growth Stage:    [startup/growth/enterprise]

TECHNOGRAPHICS:
- Current Stack:   [tools they use today]
- Infrastructure:  [cloud, on-prem, hybrid]
- Maturity:        [early adopter, mainstream, laggard]

BUSINESS CHARACTERISTICS:
- Pain Intensity:  [how acute is the problem we solve]
- Budget Authority:[does this level have budget]
- Buying Process:  [simple, committee, procurement]
- Contract Value:  [expected ACV range]

QUALIFYING SIGNALS:
- Positive: [hiring for X role, using Y tool, in Z market]
- Negative: [too small, wrong industry, already solved]

DISQUALIFYING CRITERIA:
- [specific reasons to exclude]
```

### ICP Scoring Matrix

| Attribute | Ideal (5) | Good (3) | Poor (1) | Weight |
| --- | --- | --- | --- | --- |
| Industry | [exact verticals] | [adjacent verticals] | [unrelated] | 20% |
| Company Size | [sweet spot range] | [workable range] | [too small/large] | 15% |
| Pain Intensity | Active seeking solution | Aware of problem | Unaware | 25% |
| Budget | Dedicated budget exists | Can find budget | No budget | 20% |
| Tech Fit | Perfect stack match | Partial overlap | Incompatible | 10% |
| Champion | Identified internal advocate | Potential champion | No access | 10% |

```
SCORING THRESHOLDS:
  4.0-5.0: Tier 1 — pursue aggressively
  3.0-3.9: Tier 2 — pursue selectively
  2.0-2.9: Tier 3 — qualify carefully
  < 2.0:   Disqualify
```

## Buyer Persona Template

### Full Persona Document

```
BUYER PERSONA:

──────────────────────────────────────────────
NAME:   [Representative name, e.g., "Marketing Maria"]
ROLE:   [Title / function]
REPORTS TO: [Their boss's role]
──────────────────────────────────────────────

DEMOGRAPHICS:
- Age Range:      [25-35, 35-45, etc.]
- Education:      [Degree, field]
- Career Stage:   [IC, manager, director, VP, C-level]
- Income Range:   [if relevant to pricing]

PROFESSIONAL CONTEXT:
- Team Size:      [who they manage]
- Budget Authority: [Y/N, amount range]
- KPIs They Own:   [what they're measured on]
- Tools They Use:  [current stack]
- Reports They Read: [information sources]

GOALS (what they're trying to achieve):
1. [Primary business goal]
2. [Secondary business goal]
3. [Personal career goal]

PAIN POINTS (what frustrates them):
1. [Primary pain point]
   Impact: [time, money, reputation]
2. [Secondary pain point]
   Impact: [time, money, reputation]
3. [Tertiary pain point]
   Impact: [time, money, reputation]

BUYING BEHAVIOR:
- Trigger Event:     [what initiates their search]
- Research Process:  [where they look for solutions]
- Decision Criteria: [ranked priorities]
  1. [e.g., ease of use]
  2. [e.g., integration with existing tools]
  3. [e.g., price/value]
  4. [e.g., vendor reputation]
  5. [e.g., implementation speed]
- Decision Timeline: [typical buying cycle length]
- Influencers:       [who else is involved]

OBJECTIONS:
1. [Common objection]
   Root Cause: [underlying concern]
2. [Common objection]
   Root Cause: [underlying concern]

MESSAGING THAT RESONATES:
- Value Prop:   "[specific statement that speaks to their goals]"
- Proof Point:  "[customer story or metric that builds credibility]"
- CTA:          "[appropriate next step for this persona]"

QUOTE:
"[A representative statement capturing their perspective,
  drawn from interviews or synthesized from research]"
```

## Data Sources for Persona Building

### Primary Research Methods

| Method | Best For | Sample Size | Time Investment |
| --- | --- | --- | --- |
| **Customer interviews** | Deep qualitative insights | 10-20 per persona | 2-4 weeks |
| **Sales team interviews** | Patterns from prospect conversations | 5-10 reps | 1 week |
| **Customer success interviews** | Post-purchase behavior, retention drivers | 5-10 CSMs | 1 week |
| **Win/loss analysis** | Decision criteria and competitive dynamics | 15-30 deals | 2-3 weeks |
| **Surveys** | Quantitative validation of qualitative findings | 100-500+ | 2-3 weeks |
| **On-site observation** | Real workflow and context understanding | 5-10 visits | 4-6 weeks |

### Secondary Research Methods

| Source | Data Type | Actionability |
| --- | --- | --- |
| **CRM data** | Firmographics, deal history, conversion rates | High |
| **Product analytics** | Feature usage, engagement patterns, drop-off | High |
| **Support tickets** | Pain points, confusion areas, feature requests | High |
| **G2/Capterra reviews** | Buying criteria, competitor sentiment | Medium |
| **Social media** | Interests, content consumption, influence | Medium |
| **Census / industry data** | Market sizing, demographic baselines | Low-Medium |
| **Job postings** | Role responsibilities, tools, priorities | Medium |

### Interview Question Bank

```
DISCOVERY QUESTIONS (for persona interviews):

ROLE & CONTEXT:
- "Walk me through a typical day in your role."
- "What are the top 3 things you're measured on?"
- "Who do you report to, and what do they care about most?"
- "What tools do you use every day?"

GOALS:
- "What are you trying to accomplish this quarter/year?"
- "What does success look like in your role?"
- "If you could wave a magic wand, what would change?"

PAIN POINTS:
- "What's the most frustrating part of [process we address]?"
- "How do you currently solve [problem we address]?"
- "What have you tried that didn't work?"
- "How much time/money does this problem cost you?"

BUYING BEHAVIOR:
- "When you last evaluated a new tool, how did you start?"
- "Who else was involved in that decision?"
- "What was the single most important factor in your decision?"
- "What almost stopped you from buying?"

INFORMATION SOURCES:
- "Where do you go to learn about new tools or approaches?"
- "Which blogs, podcasts, or communities do you follow?"
- "Whose opinion do you trust most when making decisions?"
```

## Jobs-to-Be-Done Integration

### JTBD Framework for Personas

```
JOB STATEMENT FORMAT:
When [situation/trigger],
I want to [motivation/goal],
so I can [expected outcome].

EXAMPLE:
When I'm preparing the monthly board report,
I want to pull real-time metrics from all our tools,
so I can present accurate data without 4 hours of manual work.

JOB MAP:
1. DEFINE    — What triggers the need?
2. LOCATE    — Where do they search for solutions?
3. PREPARE   — What setup is required?
4. CONFIRM   — How do they validate it works?
5. EXECUTE   — What does actual usage look like?
6. MONITOR   — How do they track ongoing results?
7. MODIFY    — What adjustments happen over time?
8. CONCLUDE  — What does completion look like?
```

### Outcome-Driven Persona Layer

```
FOR EACH PERSONA, MAP:

FUNCTIONAL JOBS:
- [Core task they need to accomplish]
- [Supporting tasks around the core]

EMOTIONAL JOBS:
- [How they want to feel]
- [How they want to be perceived]

SOCIAL JOBS:
- [How they want others to see them]
- [Status or recognition they seek]

RELATED JOBS:
- [Adjacent tasks that affect their success]
- [Upstream/downstream dependencies]
```

## Segmentation Approaches

### Segmentation Decision Matrix

| Approach | Data Needed | Complexity | Actionability |
| --- | --- | --- | --- |
| **Demographic** | CRM / survey data | Low | Medium |
| **Firmographic** | Company data | Low | High (for B2B) |
| **Behavioral** | Product analytics, CRM | Medium | High |
| **Needs-based** | Interviews, surveys | Medium-High | Very High |
| **Value-based** | Revenue, CLV data | Medium | High |
| **Psychographic** | Survey, social data | High | Medium |

### Behavioral Segmentation Template

```
BEHAVIORAL SEGMENTS:

POWER USERS:
- Usage: Daily, multiple features
- Engagement: High (>X sessions/week)
- Value: High CLV, likely to expand
- Strategy: Upsell, advocacy program

REGULAR USERS:
- Usage: Weekly, core features
- Engagement: Moderate
- Value: Stable, predictable revenue
- Strategy: Feature education, expansion

AT-RISK USERS:
- Usage: Declining, sporadic
- Engagement: Low (dropping)
- Value: At risk of churn
- Strategy: Re-engagement, CSM outreach

NEW USERS:
- Usage: Onboarding phase
- Engagement: Variable
- Value: Unknown (measuring)
- Strategy: Guided onboarding, quick wins
```

## Validation and Iteration

### Persona Validation Checklist

| Validation Step | Method | Status |
| --- | --- | --- |
| Based on real data (not assumptions) | Cite sources for each attribute | [ ] |
| Validated with sales team | Sales reps recognize and agree | [ ] |
| Validated with CS team | Matches real customer behavior | [ ] |
| Quantitatively sized | Know how many of each persona exist | [ ] |
| Differentiated | Each persona triggers different actions | [ ] |
| Actionable | Marketing can write copy for each | [ ] |
| Prioritized | Clear tier 1 / tier 2 / tier 3 personas | [ ] |
| Reviewed with product | Product roadmap aligns to persona needs | [ ] |

### Persona Anti-Patterns

```
COMMON PERSONA MISTAKES:

1. OPINION-BASED PERSONAS
   Problem: Built on internal assumptions, not data
   Fix: Ground every attribute in interview/data evidence

2. TOO MANY PERSONAS
   Problem: 8+ personas dilute focus and confuse teams
   Fix: 3-5 primary personas maximum; merge similar ones

3. DEMOGRAPHIC-ONLY PERSONAS
   Problem: "Female, 35-45, suburban" tells you nothing useful
   Fix: Focus on goals, pain points, and buying behavior

4. STATIC PERSONAS
   Problem: Created once and never updated
   Fix: Quarterly review cadence with new data

5. PERSONAS WITHOUT PRIORITY
   Problem: All personas treated equally
   Fix: Rank by revenue potential and market size

6. PERSONA-MESSAGE DISCONNECT
   Problem: Personas exist but messaging ignores them
   Fix: Each persona gets specific value props and content
```

### Iteration Cadence

```
QUARTERLY REVIEW:
- Validate against latest win/loss data
- Check product analytics for behavior shifts
- Interview 3-5 recent customers
- Update pain points and priorities
- Refresh proof points and quotes

ANNUAL REBUILD:
- Full primary research cycle
- Re-validate ICP and persona segments
- Check market shifts and new competitors
- Align with updated company strategy
- Present updated personas to full org
```

## See Also

- [Marketing](../marketing/SKILL.md)
- [Product Management](../product-management/SKILL.md)
- [Sales](../sales/SKILL.md)
- [Data Science](../data-science/SKILL.md)

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Marketing and content →

From the same set117

The whole set →
generic-static-ux-designer generic-static-ux-designer is a Claude Code skill for designing static HTML, CSS, and JS interfaces with fast loads, accessibility, minimalist layouts, and no-JS fallbacks. CX Codex +1 151installs pwa-development The pwa-development Claude Code skill guides work on installable web apps with offline support. It activates for PWA builds, service worker setup, and offline-first features. CX Codex +1 150installs sales sales guides B2B deal qualification, revenue forecasting, and pipeline reviews inside your coding agent. CX Codex +1 150installs onboarding-guide-creator onboarding-guide-creator builds role-specific onboarding plans with timelines, tasks, and milestones. Use it to draft a new hire welcome guide or training program. CX Codex +1 150installs generic-static-code-reviewer generic-static-code-reviewer is a skill that checks static-site HTML, CSS and JS for bugs, security issues, page weight and accessibility before a commit. CX Codex +1 149installs podcast-producer podcast-producer is a Claude Code skill that helps plan a podcast launch, prepare episodes, and create show notes. It covers the workflow from episode idea to publication. CX Codex +1 148installs generic-react-code-reviewer generic-react-code-reviewer walks your React/TypeScript diff for bugs, security holes, render costs and accessibility gaps. Fits right before a commit or when a pull request lands on your desk. CX Codex +1 148installs security This Claude Code skill covers security architecture, incident response, and vulnerability assessment. It activates for security program design, incident handling, and reviews against frameworks such as NIST and ISO 27001. CX Codex +1 148installs

Project sponsors

Companies that keep this analytics open