Agent skill

Ideal Customer Profile

by borghei in borghei/Claude-Skills

Define a sharp Ideal Customer Profile (ICP) — firmographics, behavioral signals, JTBD, and buyer persona.

MITAuto-check passedMarketing & SEO

Install Ideal Customer Profile

skills CLI
$ npx skills add borghei/Claude-Skills --skill ideal-customer-profile -a claude-code

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

GitHub CLI
$ gh skill install borghei/Claude-Skills ideal-customer-profile --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/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/gtm/ideal-customer-profile .claude/skills/ideal-customer-profile && 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
ideal-customer-profile
GitHub stars
886
Token cost
~2.1k tokens
SKILL.md length
990 words
Files
5 (incl. scripts, references, assets)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Define a sharp Ideal Customer Profile (ICP) — firmographics, behavioral signals, JTBD, and buyer persona.

  • Works in 6 steps: Start from your best customers → Disqualify common myth-ICPs → Document the 8 dimensions → …
  • Defining a new ICP
  • SKILL.md covers When to use this skill, The 8 ICP dimensions, ICP vs Persona vs Segment and Clarify First, plus 6 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Ideal Customer Profile is an agent skill from borghei/Claude-Skills. Define a sharp Ideal Customer Profile (ICP) — firmographics, behavioral signals, JTBD, and buyer persona. Use when defining a new ICP, refining one from actual closed customers, or auditing why pipeline or conversion is poor.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts, reference files and assets (for example `assets/icp_template.md`, `references/icp-dimensions-deep.md` and `references/icp-refinement-from-data.md`).

It sits in Marketing & SEO, covering Positioning and messaging and User stories. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Defining a new ICP
  • Refining one from actual closed customers
  • Auditing why pipeline
  • Conversion is poor

Example prompts

  • “/ideal-customer-profile”

Requirements

  • Python 3

Workflow steps

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

  1. Start from your best customers
  2. Disqualify common myth-ICPs
  3. Document the 8 dimensions
  4. Build the qualification rubric
  5. Run icp_scorer.py
  6. Refresh per quarter

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Ideal Customer Profile loads about 2.1k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 990 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.1k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 990 words, ~2,120 tokens.

Download SKILL.mdSave it as .claude/skills/ideal-customer-profile/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
ideal-customer-profile
description
Define a sharp Ideal Customer Profile (ICP) — firmographics, behavioral signals, JTBD, and buyer persona. Use when defining a new ICP, refining one from actual closed customers, or auditing why pipeline or conversion is poor.
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
project-management
metadata.domain
go-to-market
metadata.updated
2026-05-27
metadata.python-tools
icp_scorer.py
metadata.tech-stack
icp, ideal-customer-profile, firmographics, jtbd

Ideal Customer Profile (ICP)

The sharp definition of who you serve — used by marketing for targeting, sales for qualification, and product for prioritization.

When to use this skill

  • Defining ICP for a new product / segment
  • Refining ICP from observed closed customers
  • Auditing when pipeline quality / conversion is poor
  • Pre-fundraise to articulate market position
  • Sales qualification rubric build
  • Marketing targeting for outbound + paid

The 8 ICP dimensions

  1. Firmographics — industry, vertical, size, geography, age
  2. Tech-stack signals — what they use today (and what's missing)
  3. Buyer persona — role, level, tenure, team size
  4. Jobs-to-be-done (JTBD) — what they're trying to accomplish
  5. Existing alternatives — how they solve the JTBD today
  6. Trigger events — why now (new funding, new exec, regulation, etc.)
  7. Budget authority — who controls spend
  8. Reachability — can we find + contact them via channels we have

ICP vs Persona vs Segment

  • ICP = the company/account (firmographics + tech + situation)
  • Persona = the human buyer (role + motivations + objections)
  • Segment = a cluster of similar ICPs (often by size or vertical)

Use ICP for "which companies." Use persona for "which humans within ICP."

Clarify First

Before defining the ICP, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Existing customers vs greenfield — refine from closed-won/best-customer patterns vs design-partner proxy (the real ICP comes from data, not a guess)
  • The JTBD the product solves — what customers are trying to accomplish (anchors firmographics, alternatives, and trigger events)
  • Reachable channels you have — paid / outbound / events / content / partners (an ICP you can't reach is academic; drives the Reachability dimension)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Workflow

Step 1 — Start from your best customers

If you have customers:

  • List top 20 by health, revenue, expansion
  • Find common patterns across them
  • That's your real ICP (not what you guessed)

If you don't have customers:

  • Use design partners / pilot customers as proxy
  • Be ready to revise after 10-20 real customers
Step 2 — Disqualify common myth-ICPs

Common "ICP" patterns that are wishful thinking:

  • "Companies with 100-10,000 employees" — too broad
  • "Innovative companies" — meaningless
  • "Companies that want to grow" — everyone
  • "Enterprise" — undefined; map to size

A real ICP excludes most companies.

Step 3 — Document the 8 dimensions

Per dimension, be specific.

Example for HR analytics SaaS:

DimensionDefinition
FirmographicsUS, mid-market (200-2000 EE), SaaS or services vertical, > $20M revenue, 5+ years old
Tech-stackWorkday or BambooHR + ADP or Gusto. Bonus: existing BI tool (Looker / Tableau / Mode)
Buyer personaHR Director or VP People; 5+ years tenure; built career on people analytics
JTBD"I need to be a strategic partner to the CFO/CEO; I'm stuck doing reports manually"
Existing alternativesExcel + analyst (often resigned to it); occasionally hired contractor
Trigger eventsAnnual reporting cycle just done; new CFO joined; HR analyst departed; board asking for better data
Budget authorityDirector can recommend; VP People approves $50K; CHRO approves $200K+
ReachabilitySHRM events, HR Tech podcast, LinkedIn (HR Director groups), HR Brew newsletter
Step 4 — Build the qualification rubric

For sales qualification, distill ICP to a scorable checklist:

Qualification (BANT-style):
- Industry fit: SaaS/services? (yes/no)
- Size fit: 200-2000 EE? (yes/no)
- Tech fit: Workday/BambooHR + ADP/Gusto? (yes/no)
- Authority: VP People+ in deal? (yes/no)
- Pain: actively trying to solve HR analytics? (yes/no)
- Budget: confirmed > $50K? (yes/no)
- Timeline: decision in next 6 months? (yes/no)

5+ yes = strong lead. <3 yes = disqualify.

Step 5 — Run icp_scorer.py

Audit ICP definition for specificity, score account lists against ICP.

bash
python3 project-management/gtm/ideal-customer-profile/scripts/icp_scorer.py \
  --input icp_spec.json --format markdown
Step 6 — Refresh per quarter

ICP shifts:

  • New customers reveal new patterns
  • Product evolution opens new segments
  • Market shifts (recession, regulation, competition)

Don't refresh weekly. Quarterly is healthy.

Decision frameworks

Firmographic specificity test

For each dimension, ask:

  • Could I send a list of companies matching this to my BDR tomorrow?
  • If not, sharpen.

Vague: "growing SaaS companies" Sharp: "US-headquartered B2B SaaS companies, $10M-$100M ARR, post-Series B, that have hired their first VP of Sales in last 12 months"

Show full SKILL.md (374 more words)Show less
Tech-stack signals

Tech stack reveals readiness:

  • Have a CRM = likely structured sales process
  • Have an HRIS = HR team beyond founder/HR-of-1
  • Use a specific vendor = open to category
  • Built in-house = NIH (Not Invented Here) bias risk

Tools like BuiltWith, G2, Crunchbase + scraping can reveal stack.

Trigger event types

Strongest triggers (cause buying activity):

  • New executive in role (60-day window)
  • Funding round closed (have budget; want to spend strategically)
  • M&A activity (integration needs)
  • Regulatory deadline (compliance pressure)
  • Major incident (urgent need)
  • Vendor consolidation push
  • Annual planning cycle (Q4)
  • Reorg / department restructure

Weaker triggers:

  • "They might want it"
  • "They have the budget"
Reachability test

For each ICP, can you:

  • Find them via paid acquisition? (size of audience; CPC)
  • Find them via outbound? (LinkedIn search, ZoomInfo, Apollo)
  • Find them at events? (SHRM, RSA, AWS reInvent, etc.)
  • Find them via content? (SEO keywords they search)
  • Find them via partners? (which adjacent vendors)

If unreachable, ICP is academic.

Common engagements

"Define ICP for our new product"
  1. Pull design partner / pilot data (or interview 5-10 ideal targets).
  2. Document the 8 dimensions.
  3. Build qualification rubric.
  4. Validate with sales: can they recognize these in inbound?
  5. Validate with marketing: can they target this list?
"Refine ICP from closed customers"
  1. List top 20 paying customers by health/expansion.
  2. Find patterns: size, vertical, role, trigger, tech stack.
  3. Document refined ICP.
  4. Compare to original ICP: what's different?
  5. Update qualification rubric + targeting.
  6. Sunset segments not in refined ICP.
"Pipeline conversion is bad — is it ICP?"
  1. Audit closed-won vs closed-lost ICP fit scores.
  2. Common failure: pipeline is full of "near-ICP" that don't convert.
  3. Tighten qualification; reject more aggressively at intake.

Anti-patterns to avoid

  • ICP = "everyone." Diluted GTM.
  • ICP without trigger event. Targets without urgency.
  • ICP unreachable via your channels. Academic exercise.
  • ICP that doesn't disqualify anyone. Not really an ICP.
  • Same ICP for 3 years post-launch. Customers reveal real ICP; refresh.
  • ICP defined by product, not customer. "Companies that need X" = solution-thinking.
  • ICP without qualification rubric. Sales can't apply it.

References

  • references/icp-dimensions-deep.md — 8 dimensions in depth + signals
  • references/icp-refinement-from-data.md — using closed customers to refine
  • project-management/gtm/gtm-strategy — uses ICP as input
  • project-management/strategy-frameworks/business-model-canvas — segments block
  • project-management/discovery/customer-interview-script — interview-based ICP discovery
  • marketing/competitive-teardown — competitive context
  • c-level-advisor/cro-advisor — sales context
  • c-level-advisor/cmo-advisor — marketing context

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

Files

SKILL.md and 4 other files (scripts, references, assets) in project-management/gtm/ideal-customer-profile of borghei/Claude-Skills.

  • SKILL.md
  • assets/icp_template.md
  • references/icp-dimensions-deep.md
  • references/icp-refinement-from-data.md
  • scripts/icp_scorer.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Ideal Customer Profile 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.

Ideal Customer Profile compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ideal Customer Profile this skillborghei/Claude-Skills886—~2.1kAutomated safety check: PassMIT
Audience Belief Mapperaaron-he-zhu/aaron-marketing-skills2.9k—~3.2kAutomated safety check: PassApache-2.0
Value Propositionphuryn/pm-skills27k—~1.5kAutomated safety check: PassMIT
Ideal Customer Profilephuryn/pm-skills27k—~1.5kAutomated safety check: PassMIT
Obviously Awesomewondelai/skills2.4k—~4.6kAutomated safety check: PassMIT
Product Marketing Context Globalminhnv0807/ai-business-skills610—~2.1kAutomated safety check: PassMIT

Similar skills

  • Audience Belief Mapper

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "map what our buyers believe", "capture the objections we keep hearing", or "find the switching forces that move the beachhead"; produces a belief map…

    2.9k GitHub stars~3.2k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Value Proposition

    phuryn/pm-skills

    Design a detailed value proposition using a 6-part JTBD template — Who, Why, What before, How, What after, Alternatives.

    27k GitHub stars~1.5k tokensUpdated 25 days ago
    Marketing & SEOAuto-check passed
  • Ideal Customer Profile

    phuryn/pm-skills

    Identify the Ideal Customer Profile (ICP) from research data with demographics, behaviors, JTBD, and needs.

    27k GitHub stars~1.5k tokensUpdated 25 days ago
    Marketing & SEOAuto-check passed
  • Obviously Awesome

    wondelai/skills

    Define product positioning by mapping competitive alternatives, unique attributes, and best-fit customers to the right market category.

    2.4k GitHub stars~4.6k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • Product Marketing Context Global

    minhnv0807/ai-business-skills

    A skill your agent uses when starting work on a new product, client, or market — this skill creates the file .agents/product-marketing-context-global.md that 60+ other global skills read before they…

    610 GitHub stars~2.1k tokensUpdated 27 days ago
    Marketing & SEOAuto-check passed
  • 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.

    263 GitHub stars~5.8k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Ideal Customer Profile

What does Ideal Customer Profile do?

Define a sharp Ideal Customer Profile (ICP) — firmographics, behavioral signals, JTBD, and buyer persona. Ideal Customer Profile is an agent skill from borghei/Claude-Skills. Define a sharp Ideal Customer Profile (ICP) — firmographics, behavioral signals, JTBD, and buyer persona.

When should I use Ideal Customer Profile?

Ideal Customer Profile fits situations like: defining a new ICP; refining one from actual closed customers; auditing why pipeline; conversion is poor.

How do I install Ideal Customer Profile in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill ideal-customer-profile -a claude-code`. Or copy the skill folder (project-management/gtm/ideal-customer-profile in borghei/Claude-Skills) into .claude/skills/ideal-customer-profile in your project. Claude Code loads it when a task matches its description.

How do I install Ideal Customer Profile in Codex?

Run `npx skills add borghei/Claude-Skills --skill ideal-customer-profile -a codex`. Or copy the skill folder (project-management/gtm/ideal-customer-profile in borghei/Claude-Skills) into .agents/skills/ideal-customer-profile in your project. Codex loads it when a task matches its description.

Can I use Ideal Customer Profile 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 borghei/Claude-Skills --skill ideal-customer-profile -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ideal-customer-profile, .gemini/skills/ideal-customer-profile, .github/skills/ideal-customer-profile and .opencode/skills/ideal-customer-profile in your project.

What does Ideal Customer Profile need to run?

Going by SKILL.md and its folder, Ideal Customer Profile needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Ideal Customer Profile 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 Ideal Customer Profile 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ideal Customer Profile use?

Ideal Customer Profile is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ideal Customer Profile use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4k tokens, read only when the agent opens those files.

What are the alternatives to Ideal Customer Profile?

Skills that share tags, products or a category with Ideal Customer Profile: Audience Belief Mapper (aaron-he-zhu/aaron-marketing-skills, 2.9k stars), Value Proposition (phuryn/pm-skills, 27k stars), Ideal Customer Profile (phuryn/pm-skills, 27k stars) and Obviously Awesome (wondelai/skills, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ideal Customer Profile?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

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