Agent skill

Icp Builder

by OpenClaudia in OpenClaudia/openclaudia-skills

Define ideal customer profiles and buyer personas with structured frameworks.

MITAuto-check passedProduct & Project Management

Install Icp Builder

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill icp-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills icp-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/icp-builder .claude/skills/icp-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
icp-builder
GitHub stars
711
Token cost
~2k tokens
SKILL.md length
294 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Define ideal customer profiles and buyer personas with structured frameworks.

  • Works in 9 steps: Gather Context → ICP Framework → Pain Points and Goals → …
  • The user asks about ideal customer profile
  • SKILL.md covers Step 1: Gather Context, Step 2: ICP Framework, Step 3: Pain Points and Goals and Step 4: Objections and Barriers, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Icp Builder is an agent skill from OpenClaudia/openclaudia-skills. Define ideal customer profiles and buyer personas with structured frameworks. Use when the user asks about ideal customer profile, ICP, buyer persona, target audience definition, customer segmentation, customer research, user interviews, or persona creation. Trigger phrases include "ideal customer profile", "ICP", "buyer persona", "who is my customer", "target audience", "customer profile", "persona", "customer segmentation", "user research", "customer interview", "who should I target".

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering User research and Positioning and messaging. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user asks about ideal customer profile
  • Target audience definition
  • Customer segmentation
  • Customer research

Example prompts

  • “ideal customer profile”
  • “buyer persona”
  • “who is my customer”
  • “/icp-builder”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Gather Context
  2. ICP Framework
  3. Pain Points and Goals
  4. Objections and Barriers
  5. Channel Mapping
  6. Customer Interview Template
  7. Survey Design
  8. Persona Card Template
  9. Validation

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Icp Builder loads about 2k tokens when it runs. Until then it costs about 126 tokens; SKILL.md has 294 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 294 words, ~1,964 tokens.

Download SKILL.mdSave it as .claude/skills/icp-builder/SKILL.md (or your agent's skills folder).
name
icp-builder
description
Define ideal customer profiles and buyer personas with structured frameworks. Use when the user asks about ideal customer profile, ICP, buyer persona, target audience definition, customer segmentation, customer research, user interviews, or persona creation. Trigger phrases include "ideal customer profile", "ICP", "buyer persona", "who is my customer", "target audience", "customer profile", "persona", "customer segmentation", "user research", "customer interview", "who should I target".

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, events

Step 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.

© OpenClaudia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/icp-builder of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

Icp Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Icp Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Icp Builder this skillOpenClaudia/openclaudia-skills711—~2kAutomated safety check: PassMIT
Building ProductGTM-Strategist/gtm-strategist-skills261—~5.8kAutomated safety check: PassMIT
Jobs To Be Done Analysisdeanpeters/Product-Manager-Skills7.2k1 repos~3.5kAutomated safety check: PassCustom licence
Product Manager Toolkitborghei/Claude-Skills881—~5.8kAutomated safety check: PassMIT
Competitor MapperMaxKmet/idea-validation-agents474—~3.3kAutomated safety check: PassMIT
Foundation Stakeholder Briefingsproduct-on-purpose/pm-skills715—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Building Product

    GTM-Strategist/gtm-strategist-skills

    A skill your agent uses when the user needs to define their MVP, create a product roadmap, plan metrics and tracking, refine their value proposition with JTBD, or run usability tests.

    261 GitHub stars~5.8k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Jobs To Be Done Analysis

    deanpeters/Product-Manager-Skills

    Structures customer jobs, pains and gains in a Jobs-to-be-Done format, to clarify unmet needs, reposition a product or sharpen discovery.

    7.2k GitHub starsUsed in 1 repo~3.5k tokens
    Product & Project ManagementAuto-check passed
  • Product Manager Toolkit

    borghei/Claude-Skills

    Product manager toolkit covering RICE prioritization, customer interview analysis, PRDs, and discovery frameworks.

    881 GitHub stars~5.8k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Competitor Mapper

    MaxKmet/idea-validation-agents

    Maps the full competitive landscape — direct, indirect, substitute, and emerging competitors — with positioning gap analysis, review mining, and marketinsights-calibrated saturation scoring.

    474 GitHub stars~3.3k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed
  • Foundation Stakeholder Briefings

    product-on-purpose/pm-skills

    Turns any source artifact (spec, discovery, research, GTM plan, experiment results, retro, or raw notes) into one canonical master document plus a set of audience-tailored briefings, each re-pitched…

    715 GitHub stars~2k tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • Prd V09 Feedback Loop Setup

    mattgierhart/PRD-driven-context-engineering

    Establish channels and processes for capturing and processing post-launch feedback during PRD v0.9 Go-to-Market.

    180 GitHub stars~3.9k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    711 GitHub stars~1.2k tokensUpdated 20 days ago
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    711 GitHub stars~694 tokensUpdated 20 days ago
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    711 GitHub stars~1k tokensUpdated 20 days ago
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    711 GitHub stars~882 tokensUpdated 20 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    711 GitHub stars~1.9k tokensUpdated 20 days ago
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    711 GitHub stars~1.7k tokensUpdated 20 days ago
    Auto-check passed

Questions about Icp Builder

What does Icp Builder do?

Define ideal customer profiles and buyer personas with structured frameworks. Icp Builder is an agent skill from OpenClaudia/openclaudia-skills. Define ideal customer profiles and buyer personas with structured frameworks.

When should I use Icp Builder?

Icp Builder fits situations like: the user asks about ideal customer profile; target audience definition; customer segmentation; customer research.

How do I install Icp Builder in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill icp-builder -a claude-code`. Or copy the skill folder (skills/icp-builder in OpenClaudia/openclaudia-skills) into .claude/skills/icp-builder in your project. Claude Code loads it when a task matches its description.

How do I install Icp Builder in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill icp-builder -a codex`. Or copy the skill folder (skills/icp-builder in OpenClaudia/openclaudia-skills) into .agents/skills/icp-builder in your project. Codex loads it when a task matches its description.

Can I use Icp Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenClaudia/openclaudia-skills --skill icp-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/icp-builder, .gemini/skills/icp-builder, .github/skills/icp-builder and .opencode/skills/icp-builder in your project.

What does Icp Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Icp Builder is instructions for the agent only.

Does Icp Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Icp Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Icp Builder use?

Icp Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Icp Builder use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Icp Builder?

Skills that share tags, products or a category with Icp Builder: Building Product (GTM-Strategist/gtm-strategist-skills, 261 stars), Jobs To Be Done Analysis (deanpeters/Product-Manager-Skills, 7.2k stars), Product Manager Toolkit (borghei/Claude-Skills, 881 stars) and Competitor Mapper (MaxKmet/idea-validation-agents, 474 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Icp Builder?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 711 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.