
Icp Builder
- 406 installs
- 614 repo stars
- Updated August 5, 2026
- openclaudia/openclaudia-skills
icp-builder is a Claude Code skill that defines ideal customer firmographics, jobs-to-be-done, triggers, and objections for developers and marketers who need one sharp buyer profile before writing messaging, ads, or cont
About
icp-builder is an agent skill from openclaudia/openclaudia-skills for building ideal customer profiles and buyer personas with structured frameworks. Trigger phrases include ideal customer profile, ICP, buyer persona, target audience, customer segmentation, user research, and customer interview. The workflow captures firmographics, jobs-to-be-done, buying triggers, and objection maps so messaging, ads, and content target a single sharp buyer instead of a vague everyone audience. Developers and growth engineers reach for it when positioning a SaaS feature, drafting landing copy, or planning interview guides before implementation sprints. Outputs include a documented ICP, persona sheets, segmentation criteria, and interview question lists grounded in jobs-to-be-done language.
- Captures firmographics and buyer roles
- Documents pains, triggers, and objections
- Defines disqualifiers to avoid wasted spend
- Feeds content strategy, ads, and keyword focus
Icp Builder by the numbers
- 406 all-time installs (skills.sh)
- +19 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #207 of 853 Sales & Marketing skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/openclaudia/openclaudia-skills --skill icp-builderAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 406 |
|---|---|
| repo stars | ★ 614 |
| Last updated | August 5, 2026 |
| Repository | openclaudia/openclaudia-skills ↗ |
How do you define an ideal customer profile?
Define ideal customer firmographics, jobs-to-be-done, triggers, and objections so messaging, ads, and content speak to one sharp buyer—not everyone.
Who is it for?
Developers and marketers scoping a SaaS or product launch who need a concrete ICP before writing copy, ads, or interview scripts.
Skip if: Skip icp-builder when buyer research is complete or the task is purely technical implementation without positioning work.
When should I use this skill?
The user mentions ICP, buyer persona, target audience, customer segmentation, or who to target with messaging and content.
What you get
ICP document, buyer persona sheet, segmentation criteria, and objection map.
- ICP document
- Buyer persona sheet
Files
Ideal Customer Profile (ICP) Builder
You are an expert in customer research and persona development. When the user asks you to define their ideal customer, build personas, or segment their audience, follow this framework.
Step 1: Gather Context
Establish: product/service, problem solved, current customers (if any), market type (B2B/B2C), price point, sales motion (self-serve/sales-assisted/enterprise), stage (pre-launch/early/growth), existing data (analytics, CRM, surveys), geography.
Step 2: ICP Framework
B2B ICP (Company-Level)
FIRMOGRAPHICS
Industry: [specific verticals]
Size (employees): [range] | Size (revenue): [range]
Growth Stage: [startup/scaleup/enterprise/public]
Geography: [regions] | Business Model: [SaaS/e-comm/agency/etc.]
TECHNOGRAPHICS
Tech Stack: [tools they use] | Current Solution: [for this problem]
Technical Maturity: [early adopter/mainstream/laggard]
SITUATIONAL TRIGGERS (events creating buy urgency)
- [e.g., "Just raised funding", "Grew past 50 employees"]
- [e.g., "Current contract ending", "New VP hired"]
QUALIFYING CRITERIA
Must-Have: [e.g., "Marketing team of 3+", "Spends $10K+/mo on ads"]
Nice-to-Have: [e.g., "Active on social media"]
Disqualifying: [e.g., "Pre-revenue", "Fewer than 10 employees"]B2C ICP (Individual-Level)
DEMOGRAPHICS
Age: [range] | Income: [bracket] | Location: [region]
Life Stage: [student/early career/parent/retiree]
PSYCHOGRAPHICS
Values: [what they care about deeply]
Identity: [how they see themselves]
Aspirations: [what they're working toward]
Influences: [who shapes their decisions]
BEHAVIORAL TRAITS
Platforms: [social, search, forums]
Content: [podcasts, newsletters, YouTube]
Purchase behavior: [impulse vs. research-heavy]
Brand loyalty: [switches easily vs. sticky]Step 3: Pain Points and Goals
Pain Point Structure
Pain Point: [Specific problem]
Severity: [1-10] | Frequency: [daily/weekly/monthly]
Current workaround: [how they handle it today]
Cost of inaction: [what happens if unsolved]
Emotional impact: [frustration/anxiety/embarrassment]
Quote: "[Representative customer quote]"Categories: Functional (task is hard/slow), Financial (costs too much), Process (workflows broken), Social (look bad to boss/peers), Emotional (stress/overwhelm).
Goals
Primary Goal: [#1 outcome] | Metric: [how measured] | Timeframe: [expected]
Secondary Goals: [2-3 additional outcomes]
Dream Outcome: [if everything went perfectly]
JTBD: "When I [situation], I want to [action], so I can [outcome]."Step 4: Objections and Barriers
PRICE: "We don't have budget" -> [Response framework + evidence needed]
TIMING: "Not ready to switch" -> [Cost of waiting + easy migration]
TRUST: "Never heard of you" -> [Social proof + guarantee]
INERTIA: "Current solution works" -> [Hidden costs of status quo]
AUTHORITY: "Need manager approval" -> [Business case template]
TECHNICAL: "Will it integrate?" -> [Integration docs + support]Step 5: Channel Mapping
| Channel | Relevance (1-5) | Content Type | Cost |
|---------|----------------|-------------|------|
| Google Search | [score] | SEO/ads | free/paid |
| LinkedIn | [score] | posts/ads | free/paid |
| Twitter/X | [score] | threads | free |
| Reddit | [score] | community | free |
| Podcasts | [score] | guest/sponsor | free/paid |
| YouTube | [score] | tutorials | free/paid |
| Newsletters | [score] | sponsorships | paid |
TOP 3 CHANNELS: [channel + why + tactic]
CONTENT CONSUMED: Specific podcasts, newsletters, influencers, communities, eventsStep 6: Customer Interview Template
Target 10-15 interviews. Mix: current customers (5-7), churned (2-3), prospects (3-5). 30-45 min calls.
CONTEXT (5 min)
1. Tell me about your role and typical day.
2. Biggest challenges in [relevant area]?
3. How do you currently handle [problem]?
PROBLEM (10 min)
4. Walk me through the last time [problem occurred].
5. Most frustrating part?
6. How often does this come up?
7. What happens if it doesn't get solved?
8. What have you tried before?
SOLUTION (10 min)
9. What tools have you used?
10. What do you like about your current solution?
11. What would you change?
12. Ideal solution looks like?
BUYING (10 min)
13. How did you find your current tool?
14. Who else was involved in the decision?
15. What would make you switch?
16. What would hold you back?
17. What would you pay for [key benefit]?
CLOSE: Anything else? Know anyone similar who'd chat?Synthesis Template
COMMON THEMES: [theme, mentioned by X/n, key quotes]
SURPRISING FINDINGS: [unexpected insights]
VALIDATED ASSUMPTIONS: [confirmed]
INVALIDATED ASSUMPTIONS: [disproven -- critical]
ICP ADJUSTMENTS: [changes based on findings]Step 7: Survey Design
10-15 questions, 5-7 minutes. Use after interviews for quantitative validation.
Screening (2-3 Qs): Role, company size, do they [relevant activity]? Problem (3-4 Qs): Frequency, severity (1-10), current solution, satisfaction (1-10). Solution (3-4 Qs): Feature ranking, switch triggers, willingness to pay. Demographics (2-3 Qs): Industry, budget, open to follow-up?
Minimum: 100 responses for quantitative, 30 for directional insights.
Step 8: Persona Card Template
Create 2-4 personas:
PERSONA: [Name, e.g., "Marketing Mary"]
Role: [title] | Company: [type] | Age: [range]
BIO: [2-3 sentences: professional life, challenges, aspirations]
GOALS FRUSTRATIONS
- [Goal 1] - [Frustration 1]
- [Goal 2] - [Frustration 2]
- [Goal 3] - [Frustration 3]
TOOLS: [3-5 tools] CHANNELS: [3-5 trusted channels]
BUYING: Research style [self/peer/sales], Decision speed [fast/slow],
Budget authority [yes/needs approval]
MESSAGING: Do say "[appeals to them]" | Don't say "[turns them off]"
Key benefit: [#1 thing they care about]
Proof needed: [evidence type that convinces them]
OBJECTION: "[Biggest hesitation]" -> Response: "[How to address]"
JTBD: "When I [situation], I want to [action], so I can [outcome]."
QUOTE: "[Representative mindset quote]"Step 9: Validation
Checklist
- [ ] Based on data (interviews, surveys, analytics), not just assumptions
- [ ] 10+ customers/prospects match the profile
- [ ] ICP customers have higher LTV and lower churn
- [ ] ICP customers are reachable through identified channels
- [ ] Specific enough to guide decisions, not so narrow market is too small
- [ ] Documented and shared with all customer-facing teams
When to Update
After every 50 new customers, after pricing changes, after major features, after new market entry, quarterly minimum.
Output Format
IDEAL CUSTOMER PROFILE: [Product]
==================================
EXECUTIVE SUMMARY: [2-3 sentences]
COMPANY/CUSTOMER PROFILE: [Full details]
PAIN POINTS AND GOALS: [Ranked with severity]
BUYER PERSONAS: [2-4 persona cards]
OBJECTION HANDLING: [Top objections + responses]
CHANNEL STRATEGY: [Where to find them]
RESEARCH TEMPLATES: [Interview + survey instruments]
VALIDATION PLAN: [How to confirm and refine]Ground in evidence. Label assumptions vs. validated insights. Make actionable for marketing copy, ad targeting, content strategy, and sales outreach.
Related skills
FAQ
What does icp-builder produce?
icp-builder produces ideal customer profile documents, buyer persona sheets, segmentation criteria, and objection maps. Outputs use jobs-to-be-done framing for messaging, ads, and content.
When should developers invoke icp-builder?
icp-builder fits during validation when positioning is unclear and copy targets everyone. Invoke it for ICP, persona, segmentation, or customer interview planning before build sprints.