New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Research a company's ideal customer profiles

ICP Persona Builder

by gooseworks-ai · MIT license · ★ 1,220 on GitHub · updated Sep 21

ICP Persona Builder cover

Research a company's ideal customer profiles and build detailed synthetic buyer personas. Identifies 4-6 distinct buyer segments through web research, then creates rich, realistic personas with demographics, motivations, skepticism…

---
name: buyer-persona-generator
description: >
  Research a company's ideal customer profiles and build detailed synthetic buyer personas.
  Identifies 4-6 distinct buyer segments through web research, then creates rich,
  realistic personas with demographics, motivations, skepticism profiles, decision
  criteria, and language patterns. Use when you need to understand who your buyers are
  at a deep level — their motivations, objections, and how they evaluate solutions.
tags: [research]
---

# ICP Persona Builder

Research a company's buyer segments and build detailed synthetic personas that model their ideal customers. These personas become a reusable client asset — once built, any skill can load them to evaluate content, messaging, websites, or campaigns through buyer eyes.

## Quick Start

```

Overview

Research a company's buyer segments and build detailed synthetic personas that model their ideal customers. These personas become a reusable client asset — once built, any skill can load them to evaluate content, messaging, websites, or campaigns through buyer eyes.

What you get

  • Segment overview tableAll segments with key attributes at a glance
  • Persona summaries2-3 sentence summary of each persona
  • Coverage checkConfirm diversity rules are met (technical, business, skeptical, researcher)
  • Next stepsSuggest running icp-website-audit or other skills that can use the personas
Manual install (npx, ZIP)
Claude Codenpx skills add gooseworks-ai/goose-skills --skill buyer-persona-generator -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/gooseworks-ai/goose-skills/tar.gz/615c685f34f8 \ | tar -xz -C ~/.claude/skills --strip-components=4 goose-skills-615c685f34f8/skills/research/capabilities/buyer-persona-generator
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/cf7db923b5441e4d4861/buyer-persona-generator.zip" -OutFile "$env:TEMP\buyer-persona-generator.zip"; Expand-Archive "$env:TEMP\buyer-persona-generator.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md8.5 KB
  • skill.meta.json269 B
Read the files here
gooseworks-ai/615c6852 files
SKILL.md
Show the full text184 lines

ICP Persona Builder

Research a company's buyer segments and build detailed synthetic personas that model their ideal customers. These personas become a reusable client asset — once built, any skill can load them to evaluate content, messaging, websites, or campaigns through buyer eyes.

Quick Start

Build ICP personas for [company]. Their site is [url].

With known ICPs:

Build personas for [company]. Their ICPs are: [ICP 1], [ICP 2], [ICP 3].

Inputs

Input Required Source
Company name Yes User provides
Company URL Recommended Helps with research
Known ICPs No User provides, or discovered via research
Client context file No Any existing company context file, if available

Process

Phase 1: Company Research

Understand what the company does and who they serve:

  1. WebFetch their website — homepage, product/solutions pages, pricing, "who it's for" pages
  2. WebSearch for:
    • "[company] customers" / "[company] case studies"
    • "[company] reviews" (G2, Capterra, TrustRadius)
    • "[company] vs" (comparison searches reveal buyer segments)
    • "[company] jobs" (who they're hiring to sell to / support)
  3. Extract signals:
    • What problem do they solve?
    • What's their pricing/packaging? (Signals ACV and buyer type)
    • What industries/verticals do they serve?
    • What company sizes do they target?
    • What roles/titles appear in case studies and testimonials?
    • What's their go-to-market motion? (Self-serve, sales-led, hybrid)
Phase 2: Identify ICP Segments

From the research, identify 4-6 distinct buyer segments. Each segment should represent a meaningfully different type of buyer — different role, different company profile, or different buying motivation.

For each segment, define:

Attribute Description
Segment name Short label (e.g., "Enterprise IT Leader", "Startup Founder", "Agency Operator")
Role/titles Typical job titles in this segment
Company profile Size, stage, industry, tech stack
Core pain point The #1 problem driving them to look for a solution
Buying trigger What event makes them start searching NOW
Decision criteria What matters most when evaluating (ranked)
Sophistication How well they understand the problem space and solution landscape
Alternatives What else they'd consider (competitors, DIY, status quo)
Segment size estimate Rough sense of how big this segment is for the company (primary, secondary, emerging)

Segment diversity rules:

  • At least one technical buyer (evaluates capabilities, architecture, integrations)
  • At least one business buyer (evaluates ROI, outcomes, competitive advantage)
  • At least one skeptical profile (has been burned before, hard to convince)
  • At least one junior/researcher (doing initial research for a decision-maker)
  • Try to cover different company sizes if the company serves multiple tiers
Phase 3: Build Synthetic Personas

For each segment, create a detailed synthetic persona. The persona should feel like a real, specific person — not a marketing abstraction.

Persona structure:

{
  "id": "persona-slug",
  "name": "Jordan Chen",
  "segment": "Enterprise IT Leader",
  "title": "VP of Engineering",
  "company": {
    "type": "Mid-market SaaS company",
    "size": "200-500 employees",
    "stage": "Series B, scaling fast",
    "industry": "Financial services technology"
  },
  "demographics": {
    "experience_years": 12,
    "reports_to": "CTO",
    "team_size": 35,
    "budget_authority": "$50K-200K without board approval"
  },
  "situation": "Jordan's team is growing faster than their tooling can support. They've been using a patchwork of internal scripts and are losing engineering hours to maintenance. The CTO has asked Jordan to evaluate modern solutions before next quarter's planning cycle.",
  "pain_points": [
    "Team productivity is dropping as they scale",
    "Current tools don't integrate well",
    "Onboarding new engineers takes too long"
  ],
  "buying_trigger": "CTO mandate to evaluate solutions before Q3 planning",
  "decision_criteria_ranked": [
    "Enterprise security and compliance (SOC2, SSO)",
    "Integration with existing stack (GitHub, Jira, Datadog)",
    "Scalability — will this work at 2x team size?",
    "Total cost of ownership, not just sticker price",
    "Implementation timeline — needs to be live in 6 weeks"
  ],
  "skepticism_profile": {
    "trust_level": "Low — has been burned by vendor promises before",
    "research_style": "Deep dive. Reads docs, checks GitHub issues, asks peers in Slack communities",
    "key_objections": [
      "Will this actually scale or will we outgrow it in a year?",
      "What's the real implementation cost beyond the license?",
      "How good is the support when things break at 2am?"
    ]
  },
  "technical_sophistication": "High — understands the technical landscape well, can evaluate architecture decisions, wants to see under the hood",
  "language": {
    "describes_problem_as": "We need to consolidate our toolchain and reduce operational overhead",
    "searches_for": ["engineering productivity platform", "developer tools consolidation", "[competitor] alternative enterprise"],
    "red_flag_words": ["revolutionary", "AI-powered", "seamless" — overpromising triggers skepticism],
    "trust_signals": ["SOC2 badge", "customer logos in their industry", "transparent pricing", "public changelog"]
  },
  "evaluation_behavior": {
    "first_visit": "Scans headline, checks if it's for their company size, looks for enterprise/security page",
    "deep_evaluation": "Reads docs, checks integrations list, looks for case studies from similar companies",
    "social_proof_needs": "Wants to see companies their size in their industry, not just FAANG logos",
    "deal_breakers": ["No SSO/SAML", "No self-hosted option", "Pricing only available via sales call"]
  }
}
Phase 4: Save Persona Assets

Save to the client directory as reusable assets:

personas.json — Machine-readable, all personas in an array. Save to the current working directory or wherever the user prefers:

{
  "company": "Acme Corp",
  "url": "https://acme.com",
  "created": "2026-02-26",
  "segment_count": 5,
  "personas": [ ... ]
}

personas.md — Human-readable Markdown with all personas written out in prose form, easy to review and share.

segments.md — Summary table of all segments with key attributes, useful as a quick reference.

Output Summary

After building, present:

  1. Segment overview table — All segments with key attributes at a glance
  2. Persona summaries — 2-3 sentence summary of each persona
  3. Coverage check — Confirm diversity rules are met (technical, business, skeptical, researcher)
  4. Next steps — Suggest running icp-website-audit or other skills that can use the personas

Tips

  • Research depth matters. Spend real time in Phase 1. The better you understand the company's actual customers, the more realistic the personas. Don't just read the homepage — dig into reviews, case studies, job postings.
  • Make personas specific. "Marketing Manager" is too generic. "Sarah, Senior Demand Gen Manager at a 50-person B2B SaaS startup who just lost her SDR team to budget cuts" tells you exactly how she'll evaluate a tool.
  • Include the language dimension. How the persona describes their problem is often completely different from how the vendor describes their solution. This gap is where messaging fails.
  • Skepticism is the most important trait. Every persona needs a clear skepticism profile. What would make them NOT buy? What's their default assumption about vendors?
  • This skill has no code script. It's agent-executed using WebSearch and WebFetch. The structured process above guides the research and persona creation.

Dependencies

  • Web search capability (for company and ICP research)
  • Web fetch capability (for reading website pages)
  • No API keys or paid tools required
1---
2name: buyer-persona-generator
3description: >
4 Research a company's ideal customer profiles and build detailed synthetic buyer personas.
5 Identifies 4-6 distinct buyer segments through web research, then creates rich,
6 realistic personas with demographics, motivations, skepticism profiles, decision
7 criteria, and language patterns. Use when you need to understand who your buyers are
8 at a deep level — their motivations, objections, and how they evaluate solutions.
9tags: [research]
10---
11 
12# ICP Persona Builder
13 
14Research a company's buyer segments and build detailed synthetic personas that model their ideal customers. These personas become a reusable client asset — once built, any skill can load them to evaluate content, messaging, websites, or campaigns through buyer eyes.
15 
16## Quick Start
17 
18```
19Build ICP personas for [company]. Their site is [url].
20```
21 
22With known ICPs:
23```
24Build personas for [company]. Their ICPs are: [ICP 1], [ICP 2], [ICP 3].
25```
26 
27## Inputs
28 
29| Input | Required | Source |
30|-------|----------|--------|
31| **Company name** | Yes | User provides |
32| **Company URL** | Recommended | Helps with research |
33| **Known ICPs** | No | User provides, or discovered via research |
34| **Client context file** | No | Any existing company context file, if available |
35 
36## Process
37 
38### Phase 1: Company Research
39 
40Understand what the company does and who they serve:
41 
421. **WebFetch their website** — homepage, product/solutions pages, pricing, "who it's for" pages
432. **WebSearch** for:
44 - "[company] customers" / "[company] case studies"
45 - "[company] reviews" (G2, Capterra, TrustRadius)
46 - "[company] vs" (comparison searches reveal buyer segments)
47 - "[company] jobs" (who they're hiring to sell to / support)
483. **Extract signals:**
49 - What problem do they solve?
50 - What's their pricing/packaging? (Signals ACV and buyer type)
51 - What industries/verticals do they serve?
52 - What company sizes do they target?
53 - What roles/titles appear in case studies and testimonials?
54 - What's their go-to-market motion? (Self-serve, sales-led, hybrid)
55 
56### Phase 2: Identify ICP Segments
57 
58From the research, identify **4-6 distinct buyer segments**. Each segment should represent a meaningfully different type of buyer — different role, different company profile, or different buying motivation.
59 
60For each segment, define:
61 
62| Attribute | Description |
63|-----------|-------------|
64| **Segment name** | Short label (e.g., "Enterprise IT Leader", "Startup Founder", "Agency Operator") |
65| **Role/titles** | Typical job titles in this segment |
66| **Company profile** | Size, stage, industry, tech stack |
67| **Core pain point** | The #1 problem driving them to look for a solution |
68| **Buying trigger** | What event makes them start searching NOW |
69| **Decision criteria** | What matters most when evaluating (ranked) |
70| **Sophistication** | How well they understand the problem space and solution landscape |
71| **Alternatives** | What else they'd consider (competitors, DIY, status quo) |
72| **Segment size estimate** | Rough sense of how big this segment is for the company (primary, secondary, emerging) |
73 
74**Segment diversity rules:**
75- At least one **technical** buyer (evaluates capabilities, architecture, integrations)
76- At least one **business** buyer (evaluates ROI, outcomes, competitive advantage)
77- At least one **skeptical** profile (has been burned before, hard to convince)
78- At least one **junior/researcher** (doing initial research for a decision-maker)
79- Try to cover different company sizes if the company serves multiple tiers
80 
81### Phase 3: Build Synthetic Personas
82 
83For each segment, create a detailed synthetic persona. The persona should feel like a real, specific person — not a marketing abstraction.
84 
85**Persona structure:**
86 
87```json
88{
89 "id": "persona-slug",
90 "name": "Jordan Chen",
91 "segment": "Enterprise IT Leader",
92 "title": "VP of Engineering",
93 "company": {
94 "type": "Mid-market SaaS company",
95 "size": "200-500 employees",
96 "stage": "Series B, scaling fast",
97 "industry": "Financial services technology"
98 },
99 "demographics": {
100 "experience_years": 12,
101 "reports_to": "CTO",
102 "team_size": 35,
103 "budget_authority": "$50K-200K without board approval"
104 },
105 "situation": "Jordan's team is growing faster than their tooling can support. They've been using a patchwork of internal scripts and are losing engineering hours to maintenance. The CTO has asked Jordan to evaluate modern solutions before next quarter's planning cycle.",
106 "pain_points": [
107 "Team productivity is dropping as they scale",
108 "Current tools don't integrate well",
109 "Onboarding new engineers takes too long"
110 ],
111 "buying_trigger": "CTO mandate to evaluate solutions before Q3 planning",
112 "decision_criteria_ranked": [
113 "Enterprise security and compliance (SOC2, SSO)",
114 "Integration with existing stack (GitHub, Jira, Datadog)",
115 "Scalability — will this work at 2x team size?",
116 "Total cost of ownership, not just sticker price",
117 "Implementation timeline — needs to be live in 6 weeks"
118 ],
119 "skepticism_profile": {
120 "trust_level": "Low — has been burned by vendor promises before",
121 "research_style": "Deep dive. Reads docs, checks GitHub issues, asks peers in Slack communities",
122 "key_objections": [
123 "Will this actually scale or will we outgrow it in a year?",
124 "What's the real implementation cost beyond the license?",
125 "How good is the support when things break at 2am?"
126 ]
127 },
128 "technical_sophistication": "High — understands the technical landscape well, can evaluate architecture decisions, wants to see under the hood",
129 "language": {
130 "describes_problem_as": "We need to consolidate our toolchain and reduce operational overhead",
131 "searches_for": ["engineering productivity platform", "developer tools consolidation", "[competitor] alternative enterprise"],
132 "red_flag_words": ["revolutionary", "AI-powered", "seamless" — overpromising triggers skepticism],
133 "trust_signals": ["SOC2 badge", "customer logos in their industry", "transparent pricing", "public changelog"]
134 },
135 "evaluation_behavior": {
136 "first_visit": "Scans headline, checks if it's for their company size, looks for enterprise/security page",
137 "deep_evaluation": "Reads docs, checks integrations list, looks for case studies from similar companies",
138 "social_proof_needs": "Wants to see companies their size in their industry, not just FAANG logos",
139 "deal_breakers": ["No SSO/SAML", "No self-hosted option", "Pricing only available via sales call"]
140 }
141}
142```
143 
144### Phase 4: Save Persona Assets
145 
146Save to the client directory as reusable assets:
147 
148**`personas.json`** — Machine-readable, all personas in an array. Save to the current working directory or wherever the user prefers:
149```json
150{
151 "company": "Acme Corp",
152 "url": "https://acme.com",
153 "created": "2026-02-26",
154 "segment_count": 5,
155 "personas": [ ... ]
156}
157```
158 
159**`personas.md`** — Human-readable Markdown with all personas written out in prose form, easy to review and share.
160 
161**`segments.md`** — Summary table of all segments with key attributes, useful as a quick reference.
162 
163## Output Summary
164 
165After building, present:
1661. **Segment overview table** — All segments with key attributes at a glance
1672. **Persona summaries** — 2-3 sentence summary of each persona
1683. **Coverage check** — Confirm diversity rules are met (technical, business, skeptical, researcher)
1694. **Next steps** — Suggest running `icp-website-audit` or other skills that can use the personas
170 
171## Tips
172 
173- **Research depth matters.** Spend real time in Phase 1. The better you understand the company's actual customers, the more realistic the personas. Don't just read the homepage — dig into reviews, case studies, job postings.
174- **Make personas specific.** "Marketing Manager" is too generic. "Sarah, Senior Demand Gen Manager at a 50-person B2B SaaS startup who just lost her SDR team to budget cuts" tells you exactly how she'll evaluate a tool.
175- **Include the language dimension.** How the persona describes their problem is often completely different from how the vendor describes their solution. This gap is where messaging fails.
176- **Skepticism is the most important trait.** Every persona needs a clear skepticism profile. What would make them NOT buy? What's their default assumption about vendors?
177- **This skill has no code script.** It's agent-executed using WebSearch and WebFetch. The structured process above guides the research and persona creation.
178 
179## Dependencies
180 
181- Web search capability (for company and ICP research)
182- Web fetch capability (for reading website pages)
183- No API keys or paid tools required
184 
View all files on GitHub →

Details

Updated
Sep 21, 2026
License
MIT
Stars on the repo
★ 1,220
Checked
Source
gooseworks-ai/goose-skills ↗
Creator
gooseworks-ai · 206 listings
View creator

Made with buyer-persona-generator

ICP Persona Builder — CleanShot 2026-07-13 at 20 16 54@2x (from the gooseworks-ai/goose-skills README)
ICP Persona Builder — CleanShot 2026-07-13 at 20 16 54@2x (from the gooseworks-ai/goose-skills README)

by gooseworks-ai

Similar skills

See all →
SkillAct as a comprehensive AI sales intelligenceAI Sales Team — Main Orchestratorzubair-trabzada/ai-sales-team-claude · by zubair-trabzadaYou are a comprehensive AI sales intelligence and outreach system for Claude Code. You help founders, sales teams, agency owners, and…★ 1.4k GitHub starsSkillAutonomous cold email campaign launcherAuto research publicgrowthenginenowoslawski/coldoutboundskills · by growthenginenowoslawskiAutonomous cold email campaign launcher. Takes one target company domain, scrapes their website, generates an ICP with Claude, pulls matching leads via Prospeo, enriches emails + company descriptions, personalizes each lead with parallel Claude Code Task sub-agents (A/B/C variants), and uploads as a live Smartlead campaign. Uses local JSON files for state (no database required). Use for automated daily campaign launches after you have an initial `client-profile.yaml` from /icp-onboarding. Triggers on "auto-research", "launch an automated campaign", "daily campaign", "run the research loop".★ 736 GitHub starsSkillRun a full Account-Based Marketing campaign end-to-endABM Campaign — DIY Playbookexplorium-ai/gtm-skills · by explorium-aiABM campaign skill for Claude Code: run a full Account-Based Marketing campaign end-to-end — from ICP definition to live LinkedIn Ads. Builds targeted account lists with Vibe Prospecting, enriches and scores companies with real-time B2B data, generates personalized ad creatives with Claude Code and Figma, pushes matched audiences to LinkedIn Ads, and monitors campaigns daily at scale. The complete GTM skill for AI-driven account-based marketing in Claude Code, Codex, Hermes-Agent, and OpenClaw. No agency needed.★ 197 GitHub starsSkillContact data skill for Claude Code and Codex: build a rankedAccount contact shortlistexplorium-ai/gtm-skills · by explorium-aiContact data skill for Claude Code and Codex: build a ranked shortlist of decision-makers and contacts at a target company for outbound prospecting, deal acceleration, or renewal/expansion plays. Returns verified contact data including email, phone, LinkedIn profile, title, seniority, and department. Provide a company name or domain plus optional seniority focus or use case. Use for contact data enrichment, LinkedIn profile lookup, and building outbound contact lists. Works in Claude Code, Codex, Hermes-Agent, and OpenClaw.★ 197 GitHub starsSkillLead scoring and buying signals skill for Claude CodeAccount fit rankexplorium-ai/gtm-skills · by explorium-aiLead scoring and buying signals skill for Claude Code and Codex: rank a list of accounts by ICP fit, buying intent, real-time trigger events, and workforce momentum. Returns composite score (0-100), tier (A/B/C), and a 'why now' signal per account. Use for account-based selling, ABM list prioritization, territory planning, signal-based selling, and buyer-intent ranking. Triggers on 'score these accounts', 'rank by ICP fit and intent', 'prioritize this account list', 'which accounts have the strongest buying signals', 'ICP scoring', 'account prioritization'. Works in Claude Code, Codex, Hermes-Agent, OpenClaw, and Claude Cowork.★ 197 GitHub starsSkillRun end-to-end B2B cold-email outreach through the Hyper MCPhyperfx-ai/marketing-skills · by hyperfx-aiRun end-to-end B2B cold-email outreach through the Hyper MCP — enrich prospects with Apollo, scrape per-prospect signals from company sites and LinkedIn, draft personalized emails using proven hook frameworks, send via Gmail with safe defaults, and route replies into labeled folders. Use when the user wants to write cold emails, run an outbound sequence, prospect a list, build a follow-up cadence, "reach out to leads," or asks why nobody is replying to their cold emails.★ 90 GitHub stars

More from gooseworks-ai

SkillMine the highest-converting ad angles from customer reviewsAd angle minergooseworks-ai/goose-skills · by gooseworks-aiMine the highest-converting ad angles from customer reviews, Reddit complaints, support tickets, and competitor ads. Extracts actual pain language, competitor weaknesses, and outcome phrases that real buyers use. Outputs a ranked angle bank with proof quotes and recommended ad formats per angle.★ 1.2k GitHub starsSkillAnalyze ad campaign performance data to identify what'sAd campaign analyzergooseworks-ai/goose-skills · by gooseworks-aiAnalyze ad campaign performance data (Google, Meta, LinkedIn) to identify what's working, what's wasting budget, and specific cut/scale/test recommendations. Runs statistical analysis, funnel diagnostics, and multi-channel budget reallocation with specific dollar-amount shift recommendations and scenario modeling.★ 1.2k GitHub starsSkillFor paid lead-gen and participant-recruitment adsAd lead quality analyzergooseworks-ai/goose-skills · by gooseworks-aiFor paid lead-gen and participant-recruitment ads, replaces vanity CPA with true CAC per qualified lead by joining ad-platform data with downstream funnel events, surfaces tracking gaps, and classifies every creative into Scale / Keep / Investigate / Cut.★ 1.2k GitHub starsSkillAnalyze the message match between your ads and landing pagesAd to landing page auditorgooseworks-ai/goose-skills · by gooseworks-aiAnalyze the message match between your ads and landing pages. Checks if the promise in the ad copy carries through to the landing page headline, body, and CTA. Flags disconnects that kill conversion rates. Works with Google, Meta, and LinkedIn ads.★ 1.2k GitHub starsSkillCheck and improve your brand's visibility across AI searchAeogooseworks-ai/goose-skills · by gooseworks-aiCheck and improve your brand's visibility across AI search engines (ChatGPT, Perplexity, Gemini, Grok, Claude, DeepSeek). Set up tracking, run visibility analyses, audit your website for AI readability, and get actionable recommendations. Uses the npx goose-aeo@latest CLI.★ 1.2k GitHub starsSkillSearch Amazon products - find items, compare pricesAmazon Product Searchgooseworks-ai/goose-skills · by gooseworks-aiSearch Amazon products - find items, compare prices, read reviews★ 1.2k GitHub stars