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.
npx skills add phuryn/pm-skills --skill ideal-customer-profile -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/ideal-customer-profile/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ideal-customer-profile/
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill ideal-customer-profile -a codex2Manually: put the files in place
.agents/skills/ideal-customer-profile/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill ideal-customer-profile -a cursor2Manually: put the files in place
.cursor/skills/ideal-customer-profile/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install phuryn/pm-skills ideal-customer-profile2Manually: put the files in place
.github/skills/ideal-customer-profile/SKILL.md1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill ideal-customer-profile -a gemini-cli2Platform CLI
gemini skills install https://github.com/phuryn/pm-skills --path pm-go-to-market/skills/ideal-customer-profileManually: put the files in place
.devin/skills/ideal-customer-profile/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill ideal-customer-profile -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set61
The whole set →Similar
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