Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

ideal-customer-profile — Claude Code skill: overview & install

Synthesizes customer survey data and interview transcripts into an Ideal Customer Profile (ICP). Built for product-market fit analysis and value segmentation.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add phuryn/pm-skills --skill ideal-customer-profile -a claude-code
Open on GitHub

What ideal-customer-profile does

This skill turns customer research, PMF survey responses, and support data into a structured buyer profile. It applies Clayton Christensen's Jobs to Be Done framework. The goal is pinpointing who gets the highest value from the product, retains longest, and expands contract size.

The workflow breaks down into six steps. It groups accounts by lifetime value and churn rates before extracting firmographic patterns. Next, it maps functional, emotional, and social customer jobs. The final summary outlines five to seven core pain points, the decision timeline, and explicit disqualification criteria for poor-fit accounts.

Raw data enters through the $ARGUMENTS parameter. Feeding vague notes into the prompt yields generic assumptions, which is why the instructions recommend analyzing transcripts from at least 10 high-value customers.

What it helps with

  • define an ICP based on product-market fit survey results
  • isolate customer segments with low churn and high expansion
  • map functional and emotional customer jobs using JTBD
  • document disqualification criteria for low-fit leads

Example prompts for the agent

  • Analyze our product-market fit survey responses and build an ideal customer profile
  • Review these customer interview transcripts to map out core JTBD and pain points
  • Synthesize our closed deals data to define target demographics and disqualification criteria

How to install ideal-customer-profile

1Skills CLI (Vercel)

npx skills add phuryn/pm-skills --skill ideal-customer-profile -a claude-code

2Manually: put the files in place

~/.claude/skills/ideal-customer-profile/SKILL.md

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

From the same set61

The whole set →
create-prd phuryn This skill builds a lean PRD from an 8-section template. Use it to define a feature, document product requirements, or review an existing PRD. Claude Code CX Codex Cursor +1 10,800installs pre-mortem phuryn Runs a pre-mortem risk assessment on PRDs and launch plans. Catches critical launch blockers, surfaces hidden team assumptions, and maps action items. Claude Code CX Codex Cursor +1 10,200installs outcome-roadmap phuryn Rewrites feature-heavy roadmaps into outcome-focused statements tied to business and customer impact. Helps teams replace rigid feature lists with measurable strategic goals. Claude Code CX Codex Cursor +1 9,900installs prioritization-frameworks phuryn Reference guide to 9 prioritization frameworks: RICE, ICE, Opportunity Score, Kano, MoSCoW and more. Helps you pick the right method, compare approaches, and rank tasks by importance. Claude Code CX Codex Cursor +1 9,900installs strategy-red-team phuryn Stress-tests PRDs, roadmaps, and strategies by attacking load-bearing assumptions before reality does, returning kill criteria and cheap tests. Claude Code CX Codex Cursor +1 9,200installs competitor-analysis phuryn This skill researches direct competitors and compares their positioning, strengths, weaknesses, and pricing. Use it to prepare a competitive brief or find ways to differentiate a product. Claude Code CX Codex Cursor +1 3,800installs business-model phuryn Skill generates a Business Model Canvas with all 9 building blocks: from key partners and activities to channels and revenue streams. Use it to create a business model, document how value flows, or analyze an existing business. Claude Code CX Codex Cursor +1 3,700installs privacy-policy phuryn Skill drafts a detailed privacy policy accounting for GDPR, CCPA, and other regulations. Use it when building a new product, updating data protection docs, or preparing for compliance audits. Claude Code CX Codex Cursor +1 3,500installs

Similar

acestep calesthio Generates music and vocal tracks from prompts, transfers audio style, and extracts stems. Use it for background tracks, jingles, and video audio work. Claude Code CX Codex Cursor +1 1,000installs heygen calesthio Skill for generating AI avatar videos, explainers, and presentations through the HeyGen API or MCP tools directly from agent chats. Claude Code CX Codex Cursor +1 1,000installs gtm-product-led-growth official Smit Patel (https://linkedin.com/in/smitkpatel) This skill helps choose between PLG and sales-led growth, review activation, and map channel economics. Use it for developer tools and B2B SaaS with self-serve potential. GitHub Copilot 1,800installs marketing-ideas coreyhaines31 This skill suggests marketing ideas for SaaS and software products based on their stage and available resources. Use it when you need a place to start with growth. Claude Code CX Codex Cursor +1 146,400installs revops coreyhaines31 This skill helps design RevOps workflows for lead stages, scoring, routing, and marketing-to-sales handoffs. Use it when CRM processes need clear rules. Claude Code CX Codex Cursor +1 113,000installs product-marketing coreyhaines31 Creates and maintains a shared document for product positioning, audience, and brand voice. Use it before other marketing skills so they can refer to the same context. Claude Code CX Codex Cursor +1 83,700installs brag latent-spaces Generates a short, polished launch video from project source code using Hyperframes. Requires no running server or screenshots. Claude Code CX Codex Cursor +1 20,000installs baoyu-post-to-weibo JimLiu Prepares regular Weibo posts and articles through Chrome. Use it when text, media, or a Markdown article needs to be placed in the editor for manual publishing. Claude Code CX Codex Cursor +1 21,600installs

Questions about ideal-customer-profile

How to install ideal-customer-profile in Claude Code?

Run npx skills add phuryn/pm-skills --skill ideal-customer-profile -a claude-code. You can also place the configuration directly into ~/.claude/skills/ideal-customer-profile/SKILL.md.

What does the ideal-customer-profile skill do?

It converts customer interviews, surveys, and usage data into an actionable profile of your best-fit buyer. The output covers firmographics, behavioral traits, Jobs to Be Done, and explicit disqualification flags.

What inputs does ideal-customer-profile require?

You pass research data, interview notes, or analytics through $ARGUMENTS. The author advises interviewing at least 10 high-value customers to capture reliable behavioral patterns.

Source text

SKILL.md · MIT
---
name: ideal-customer-profile
description: "Identify the Ideal Customer Profile (ICP) from research data with demographics, behaviors, JTBD, and needs. Use when defining your ICP, analyzing PMF survey data, or understanding who your best customers are."
---
# Ideal Customer Profile

## Overview
Identify your Ideal Customer Profile (ICP) from research and survey data. This skill synthesizes customer research to define the customer most likely to find value, retain, and expand with your product.

## When to Use
- Defining ICP from product-market fit survey data
- Targeting high-value customer segments
- Analyzing customer success and expansion patterns
- Prioritizing sales and marketing efforts
- Evaluating new customer opportunities for fit
- Refining target market definition

## ICP Framework Components

### Demographics
Who are they from a firmographic and personal perspective?
- Company size (employees, revenue)
- Industry or vertical
- Geographic location
- Job title and department
- Years of experience in role
- Education and background
- Organizational structure and reporting

### Behaviors
How do they work and make decisions?
- How they discover and evaluate solutions
- Buying process and decision-making timeline
- Technical literacy and product adoption speed
- Collaboration style (solo decision vs committee)
- Change management and adoption style
- Tool switching frequency
- Community involvement and peer influence

### Jobs to Be Done (JTBD)
What are they trying to accomplish?
- Primary job/goal they're trying to achieve
- Secondary jobs that support the primary job
- Emotional jobs (how they want to feel)
- Social jobs (status and perception)
- Jobs they avoid or want to eliminate
- Frequency and importance of each job
- Success metrics for completing job

### Needs and Pain Points
What problems does your product solve?
- Specific pain points they experience
- Current workarounds and limitations
- Impact on productivity or outcomes
- Cost or time burden of the problem
- Emotional frustration levels
- Barriers to solving the problem
- Available budget to solve
- Competing priorities

## How It Works

### Step 1: Gather Customer Data
Collect research about actual and potential customers:
- Product-market fit survey responses
- Customer interview transcripts
- Trial or freemium user behavior data
- Customer feedback and support tickets
- Churn analysis and customer lifecycle data
- Win/loss analysis from sales
- Competitor customer analysis

### Step 2: Segment by Value
Identify customer cohorts and their value:
- Highest LTV (lifetime value) customers
- Fastest time-to-value customers
- Lowest churn rate customers
- Highest expansion/upsell customers
- Most enthusiastic/engaged customers
- Best reference/case study potential
- Most aligned with product vision

### Step 3: Profile Demographics
Extract firmographic patterns:
- Common company sizes (employee count, revenue)
- Industry verticals and sub-verticals
- Geographic concentrations
- Typical department and reporting structure
- Budget holders and budget available
- Company stage (startup, growth, enterprise)
- Company culture indicators

### Step 4: Identify Behaviors
Map decision-making and adoption patterns:
- How they discovered your product (channel)
- Evaluation process and timeline
- Key stakeholders in decision
- Obstacles during sales process
- Product adoption speed and breadth
- Team involvement in onboarding
- Frequency of feature usage
- Support and service needs

### Step 5: Define JTBD
Articulate what they're trying to accomplish:
- Primary job/goal (functional job)
- Emotional dimensions (how they want to feel)
- Social dimensions (team and stakeholder impact)
- Success metrics (how they measure success)
- Context and constraints (when, where, with whom)
- Competing jobs and priorities
- Importance ranking of various jobs

### Step 6: Document Pain Points and Needs
Synthesize specific problem areas:
- Before state (current situation and frustrations)
- Desired after state (ideal future state)
- Gap size and impact quantification
- Emotional dimensions of the problem
- Resource constraints preventing solutions
- Skepticism or hesitations
- Success criteria for solution

## Input Format
Use $ARGUMENTS to pass:
- Research data (surveys, interviews, transcripts)
- Customer success/metrics data
- Product usage analytics
- Sales activity and win/loss data
- Existing customer database
- Competitive intelligence

## Output
A comprehensive ICP definition including:
- Firmographic profile (company size, industry, location)
- Behavioral profile (buying patterns, adoption style)
- Complete JTBD mapping (functional, emotional, social jobs)
- Top 5-7 pain points and specific needs
- Quantified impact metrics (cost of problem, value of solution)
- Decision-making process and key stakeholders
- Typical customer journey and timeline
- Go-to-market implications and messaging
- Disqualification criteria (who is NOT a good fit)
- High-value segment within ICP (ideal-of-the-ideal)

## Framework
Based on Jobs to Be Done theory by Clayton Christensen and customer profiling methodology. Combines behavioral data with motivational insights to define actionable customer profiles.

## Tips
- Use quantitative and qualitative data together
- Interview 10+ high-value customers for pattern identification
- Look for non-obvious demographic patterns (outliers can be high-value)
- Define both ideal ICP and acceptable secondary segments
- Revisit ICP quarterly as you gather more customer data
- Use ICP to evaluate all new sales opportunities
- Share ICP across entire organization (marketing, sales, product)
- Remember: ICP should drive focus, not exclude all others

---

### Further Reading

- [5 GTM Principles You Should Know as a PM](https://www.productcompass.pm/p/5-gtm-principles-with-frameworks-templates)
- [How to Design a Value Proposition Customers Can't Resist?](https://www.productcompass.pm/p/how-to-design-value-proposition-template)

© phuryn · MIT · phuryn/pm-skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor