Scrapes case studies, testimonials, and solutions pages from a target website to build structured ICP documentation. Produces TAM analysis, firmographic segments, champion and economic buyer personas, use case mapping, customer proof points, and voice-of-customer synthesis with normalized attributes. Requires website URL as primary input. Upstream: recommended company-context. Downstream: feeds positioning, product-messaging, landing-page-copy, content-strategy, and outreach-emails.
Disqualification criteria, red flags, and objection patterns
Intent signals
Company-level and persona-level signals with detection sources
Data gaps
Paragraph explaining impact of missing data and mitigation
Paragraph quality checklist
Opens with the key insight, not setup
Includes specific evidence (names, numbers, sources)
Includes URL and date for all evidence
Explains the "so what" — why this matters
Avoids generic language that could apply to any company
Workflow
Phase 1: Data extraction
Discover key pages
Fetch: [domain]/customers OR /case-studies OR /success-stories
Fetch: [domain]/solutions OR /use-cases OR /industries
Fetch: [domain]/pricing
Fetch: [domain]/integrations OR /partners
Search: site:[domain] case study testimonial
Search: site:g2.com "[company]" reviews
Search: site:linkedin.com "[company]" hiring [relevant role]
Extract raw data per source (record URL and date for each):
Customer names and logos
Job titles and roles mentioned
Industry and company size indicators
Quantified outcomes and stats
Verbatim quotes and pain point language
Use case descriptions and workflows
Tech stack and integrations
Community and content references
Normalize attributes
Attribute
Normalization rules
Geography
Map to: US, North America, EMEA, APAC, LATAM, Global
Industry
Use standard verticals: SaaS, E-commerce, Finance, Healthcare, etc.
Customer names sourced from public references only
Firmographics normalized to standard attributes
VOC quotes are verbatim with source URLs and dates
All evidence includes URL and access date
Confidence levels assigned to all key data
Data gaps documented with follow-up suggestions
1---2name: icp-research3description: Scrapes case studies, testimonials, and solutions pages from a target website to build structured ICP documentation. Produces TAM analysis, firmographic segments, champion and economic buyer personas, use case mapping, customer proof points, and voice-of-customer synthesis with normalized attributes. Requires website URL as primary input. Upstream: recommended company-context. Downstream: feeds positioning, product-messaging, landing-page-copy, content-strategy, and outreach-emails.4---56<!--
7COMMUNITY SKILL — included under its original MIT license.
8Source: https://github.com/matteotitta/genesys-skills by Matteo Titta (MIT).
9License text: ../LICENSE-genesys-skills.txt
10Curated into Growth Marketing OS by Mahmoud Omar (mahmoudomar.com) — this file
11is NOT original work by the repo author; see /skills/community/README.md.
12-->
131415# ICP research skill
1617Generate ideal customer profiles for B2B SaaS clients through systematic research and structured output.
1819## Report structure
2021The final ICP report follows this numbered section order:
2223| Section | Purpose |
24|---------|---------|
25| Header | Research date, website, category, confidence score (1-5) |
26| 1. Executive summary | High-level synthesis of findings and strategic recommendations |
27| 2. TAM analysis | Market sizing with targeting strategy per layer (TAM/SAM/SOM/ICP) |
28| 3. Firmographics analysis | Geographic, industry, company segment patterns, and technographics |
29| 4. Roles and personas | Core use case, Champion deep-dive, Economic Buyer deep-dive, buying journey |
30| 5. Negative ICP | Who is NOT a fit, disqualification criteria, and red flags |
31| 6. Customer proof points | Named customers, outcomes, and evidence with URLs |
32| 7. Voice of customer synthesis | Language patterns, pain points, and outcome terminology |
33| 8. ICP segment definitions | Scoring matrix, in-market signals, segment deep-dives |
34| 9. Intent signals and buying triggers | Observable signals indicating purchase readiness |
35| 10. Recommendations | Prioritization and messaging by segment |
36| 11. Data gaps | Missing information and follow-up suggestions |
37| 12. Source appendix | All sources with access dates, URLs, and confidence levels |
3839**Confidence score calculation**: Count High/Medium/Low data points. Score 5 if >70% High, Score 4 if >50% High, Score 3 if mixed, Score 2 if >50% Low, Score 1 if >70% Low.
4041---
4243## Output dimensions
4445Research produces structured outputs across multiple dimensions. See `references/dimension-schemas.md` for complete field definitions.
4647### TAM analysis
4849Market opportunity sizing with explicit methodology, assumptions, and targeting strategy.
5051| Field | Description |
52|-------|-------------|
53| TAM summary | Rich paragraph explaining total addressable market with methodology |
54| TAM calculation table | Metric, value, source/basis, and **targeting strategy** for each layer |
55| ICP row | Below SOM: highest priority segment based on research findings |
56| Assumptions | Documented assumptions underlying each estimate |
5758**TAM table structure:**
5960| Metric | Value | Source/Basis | Targeting strategy |
61|--------|-------|--------------|-------------------|
62| TAM | $XB | [Methodology] | Long-term market awareness and category leadership |
63| SAM | $XM | [Qualification] | Segment-specific campaigns and channel strategy |
64| SOM | $XM | [Capture estimate] | Direct sales and targeted ABM |
65| **ICP** | $XM | [Research findings] | Highest-priority accounts for immediate focus |
6667### Firmographics
6869Company attributes that define ideal customers with segment deep-dives.
7071| Field | Description |
72|-------|-------------|
73| Geography summary | Paragraph with regional patterns and evidence |
74| Geography table | Regions sorted by concentration, with URL + date evidence |
75| Industry summary | Paragraph explaining vertical patterns |
76| Industry table | Industries sorted by presence, with URL + date evidence |
77| Company segments summary | Paragraph describing size/stage patterns |
78| Segments table | Enterprise → Mid-market → SMB → Startup |
79| **Segment deep-dives** | For each segment: Priorities, ICP-fit, Budget & sales cycle, Unique approach, Proof points |
80| **Technographics** | Required tools, integrations, and tech stack indicators |
81| Adjacent stack | Common tools and integrations |
8283**Company segment deep-dive structure:**
8485For each segment (Enterprise, Mid-market, SMB), include:
86- **Priorities:** Key priorities within today's market trends and dynamics
87- **ICP-fit:** Why this segment is a good fit for our product
88- **Budget & sales cycle:** Spending power and typical cycle length
89- **Unique approach:** How we target this segment uniquely
90- **Proof points:** Stats of impact from representatives with URLs and dates
9192### Technographics
9394Required technology prerequisites and common stack patterns. This section identifies tools that indicate fit or readiness.
9596| Category | Purpose |
97|----------|---------|
98| CRM | Customer relationship management (Salesforce, HubSpot, Pipedrive) |
99| E-commerce | Commerce platforms (Shopify, BigCommerce, WooCommerce) |
100| Marketing automation | Email and automation (Klaviyo, Mailchimp, Braze, Marketo) |
101| CDP | Customer data platforms (Segment, mParticle, Rudderstack) |
102| Analytics | Product and web analytics (Amplitude, Mixpanel, Google Analytics, Posthog) |
103| Cloud | Infrastructure providers (AWS, Azure, GCP, Vercel) |
104| Data warehouse | Data storage (Snowflake, BigQuery, Redshift, Databricks) |
105| ERP | Enterprise resource planning (SAP, NetSuite, Oracle) |
106| Communication | Team communication (Slack, Microsoft Teams) |
107| Project management | Work management (Jira, Asana, Monday, Linear) |
108109**Technographics table structure:**
110111| Category | Required/Preferred | Common tools | Why it matters | Evidence |
112|----------|-------------------|--------------|----------------|----------|
113| [Category] | Required | [Tool names] | [Product dependency or integration] | [Source] ([URL], [Date]) |
114| [Category] | Preferred | [Tool names] | [Better fit or faster time-to-value] | [Source] ([URL], [Date]) |
115116### Personas
117118Who buys and uses the product, with explicit Champion and Economic Buyer deep-dives.
119120| Field | Description |
121|-------|-------------|
122| Persona overview | Rich paragraph summarizing buying committee structure |
123| Personas table | Sorted: **Champion → Economic Buyer → User → Influencer** |
124| **Core use case** | Business process definition with steps, scenarios, alternatives, drivers, outcomes |
125| **Champion deep-dive** | Explicit template for the person who drives evaluation |
126| **Economic Buyer deep-dive** | Explicit template for the person who controls budget |
127| User deep-dive(s) | Additional personas who use the product daily |
128| Use cases by role | Champion first, then by seniority |
129| Alternatives mentioned | Competitors and substitutes with URLs |
130| Buying journey | Champion → Economic Buyer → User columns |
131132**Core use case structure:**
133134- **Use case statement:** 1-2 sentences defining the business process
135- **Key steps:** Numbered steps in the process
136- **Core scenarios:** 3-4 typical scenarios
137- **Current alternatives:** Competitors, Manual, DIY approaches
138- **Business drivers:** What drives the need
139- **Desired outcomes:** What success looks like
140141**Champion deep-dive structure (12 fields):**
142143The Champion is the person who feels the pain daily, drives the evaluation, and advocates internally for the solution.
1441451. **Titles:** Title variations with context (e.g., "Manager of X, Senior Y, Lead Z")
1462. **Department & team size:** Where they sit and typical team structure
1473. **Responsibilities:** Key responsibilities in paragraph form (2-3 sentences)
1484. **Jobs to be done:** 3-5 product-agnostic jobs they're trying to accomplish
1495. **Success metrics / KPIs:** How they're measured and what success looks like
1506. **Challenges:** Things that make their job harder (obstacles they struggle with)
1517. **Pain points:** Problems that hurt them directly (negative impact they feel)
1528. **Current alternatives:** How they currently achieve goals without this product
1539. **Problems with alternatives:** Specific issues with current approach
15410. **Buying behavior:** How they typically discover and evaluate solutions
15511. **Channels & influences:** Communities, content, events, and influencers they trust
15612. **Testimonial:** Verbatim quote from case study with name, title, company, and description of product usage
157158**Economic Buyer deep-dive structure (13 fields):**
159160The Economic Buyer is the person who controls budget and makes the final purchasing decision.
1611621. **Titles:** Title variations with context (e.g., "VP of X, Director of Y, Head of Z")
1632. **Department & team size:** Where they sit, reporting structure, direct reports
1643. **Responsibilities:** Key responsibilities in paragraph form (2-3 sentences)
1654. **Jobs to be done:** 3-5 business-level jobs they're trying to accomplish
1665. **Success metrics / KPIs:** Business metrics they're accountable for
1676. **Challenges:** Business-level obstacles they face
1687. **Pain points:** Business impacts that create urgency
1698. **What they actually care about:** Beyond stated concerns — what drives decisions
1709. **Common objections:** Typical pushback during sales process
17110. **What a "no-brainer" looks like:** Conditions that make approval easy
17211. **Buying behavior:** How they evaluate and approve purchases
17312. **Channels & influences:** Where they get information and who they trust
17413. **Testimonial:** Verbatim quote from case study with name, title, company
175176### Negative ICP
177178Identifying who is NOT a fit helps sales disqualify quickly and avoid bad-fit deals.
179180| Field | Description |
181|-------|-------------|
182| Disqualification criteria | Table of attributes that indicate poor fit |
183| Red flags | Warning signs from churned or unsuccessful customers |
184| Objection patterns | Objections that signal poor fit vs. legitimate concerns |
185186### Intent signals and buying triggers
187188Observable events or behaviors indicating a company or persona is more likely to buy now.
189190| Field | Description |
191|-------|-------------|
192| Overview | Paragraph explaining signal detection strategy |
193| Company-level signals | Events at the organization level |
194| Persona-level signals | Behaviors from individual buyers |
195| Signal sources | Where to detect each signal |
196197---
198199## Sorting rules
200201Apply consistent sorting across all tables:
202203| Dimension | Sort order |
204|-----------|------------|
205| Decision role | **Champion → Economic Buyer → User → Influencer** |
206| Company size | Enterprise → Mid-market → SMB → Startup |
207| Frequency | Very high → High → Medium → Low |
208| Confidence | High → Medium → Low |
209| Customer concentration | High → Medium → Low |
210| Priority | 1 → 2 → 3 → 4 |
211| Industry presence | Strong → Moderate → Emerging |
212213---
214215## Rich description requirements
216217Every section must include contextual paragraphs, not just tables. All evidence must include URL and access date.
218219### Minimum requirements
220221| Section | Required prose |
222|---------|----------------|
223| Each macro section (1-12) | Opening paragraph (3-5 sentences) summarizing findings |
224| Each industry vertical | 2-3 sentences explaining why this industry fits and evidence |
225| Each company segment | Deep-dive with Priorities, ICP-fit, Budget & sales cycle, Unique approach, Proof points |
226| Champion persona | Full deep-dive with all 12 fields including Channels & influences |
227| Economic Buyer persona | Full deep-dive with all 13 fields including Channels & influences |
228| Core use case | Full definition with steps, scenarios, alternatives, drivers, outcomes |
229| Each ICP segment | Deep-dive with Priorities, ICP-fit, Budget & sales cycle, Unique approach, Proof points |
230| Negative ICP | Disqualification criteria, red flags, and objection patterns |
231| Intent signals | Company-level and persona-level signals with detection sources |
232| Data gaps | Paragraph explaining impact of missing data and mitigation |
233234### Paragraph quality checklist
235236- [ ] Opens with the key insight, not setup
237- [ ] Includes specific evidence (names, numbers, sources)
238- [ ] Includes URL and date for all evidence
239- [ ] Explains the "so what" — why this matters
240- [ ] Avoids generic language that could apply to any company
241242---
243244## Workflow
245246### Phase 1: Data extraction
2472481. **Discover key pages**
249 ```
250 Fetch: [domain]/customers OR /case-studies OR /success-stories
251 Fetch: [domain]/solutions OR /use-cases OR /industries
252 Fetch: [domain]/pricing
253 Fetch: [domain]/integrations OR /partners
254 Search: site:[domain] case study testimonial
255 Search: site:g2.com "[company]" reviews
256 Search: site:linkedin.com "[company]" hiring [relevant role]
257 ```
2582592. **Extract raw data** per source (record URL and date for each):
260 - Customer names and logos
261 - Job titles and roles mentioned
262 - Industry and company size indicators
263 - Quantified outcomes and stats
264 - Verbatim quotes and pain point language
265 - Use case descriptions and workflows
266 - Tech stack and integrations
267 - Community and content references
2682693. **Normalize attributes**
270271 | Attribute | Normalization rules |
272 |-----------|---------------------|
273 | Geography | Map to: US, North America, EMEA, APAC, LATAM, Global |
274 | Industry | Use standard verticals: SaaS, E-commerce, Finance, Healthcare, etc. |
275 | Company size | Revenue bands: <$1M, $1-10M, $10-50M, $50-100M, $100M+ |
276 | Team size | Employee bands: 1-10, 11-50, 51-200, 201-500, 501-1000, 1000+ |
277 | Tech stack | Category + tool name: CRM (Salesforce), CDP (Segment) |
278279### Phase 2: Analysis and synthesis
280281For each segment (by industry x company size):
2822831. **Identify patterns** across extracted data
2842. **Define core use case** with steps, scenarios, alternatives, drivers, outcomes
2853. **Build Champion deep-dive** with all 12 fields including Channels & influences
2864. **Build Economic Buyer deep-dive** with all 13 fields including Channels & influences
2875. **Map use cases** to segment-specific needs
2886. **Identify negative ICP** criteria and red flags
2897. **Identify intent signals** at company and persona level
2908. **Collect proof points** with testimonials for personas and segments
2919. **Document technographics** with required and preferred tools
29210. **Calculate TAM estimate** with targeting strategy per layer
29311. **Identify ICP** as highest-priority segment below SOM
294295### Phase 3: Structured output
296297Generate numbered sections following the report structure above.
298299Apply sorting rules to all tables (Champion first for personas).
300301Include rich descriptions with URLs and dates for all evidence.
302303Include deep-dives for company segments, personas (Champion and Economic Buyer explicitly), and ICP segments.
304305---
306307## Input requirements
308309### Required
310- **Website URL**: Primary company website
311312### Optional (improves quality)
313314| Input | Purpose |
315|-------|---------|
316| Case studies URL | Direct link to case studies page |
317| Testimonials URL | Direct link to testimonials |
318| Market context | Category, competitors, GTM approach |
319| Sales call notes | Win/loss context, objections |
320| Existing ICP docs | Validate or expand current understanding |
321322---
323324## Anti-hallucination guardrails
3253261. **Never invent customer names.** Only cite publicly referenced customers.
3272. **Quote verbatim.** Use exact customer language in quotes.
3283. **Mark confidence levels.** Tag data as High/Medium/Low confidence.
3294. **Cite sources with URLs and dates.** Include URL and access date for every claim.
3305. **Acknowledge gaps.** Explicit "Not available" for missing data.
331332| Confidence | Definition |
333|------------|------------|
334| High | Direct from official source, verifiable |
335| Medium | Third-party source, multiple signals |
336| Low | Single indirect source, inferred |
337338---
339340## Reference files
341342| File | Purpose |
343|------|---------|
344| `references/dimension-schemas.md` | Complete field definitions for all dimensions |
345| `references/icp-output-template.md` | Full report template with numbered sections |
346| `references/search-patterns.md` | Detailed search queries per data type |
347| `references/examples/example-strapi.md` | Worked example: Strapi (headless CMS) |
348349---
350351## Quality checklist
352353- [ ] All 12 numbered sections present
354- [ ] Every section has opening synthesis paragraph
355- [ ] All tables sorted per sorting rules (Champion first for personas)
356- [ ] TAM table includes ICP row with targeting strategy
357- [ ] Technographics section included with Required/Preferred tools
358- [ ] Core use case defined with steps, scenarios, alternatives, drivers, outcomes
359- [ ] Champion deep-dive includes all 12 fields with Channels & influences
360- [ ] Economic Buyer deep-dive includes all 13 fields with Channels & influences
361- [ ] Persona deep-dives include testimonials with quotes
362- [ ] Company segment deep-dives include Priorities, ICP-fit, Budget & sales cycle, Unique approach, Proof points
363- [ ] Negative ICP documented with disqualification criteria and red flags
364- [ ] Intent signals documented with company-level and persona-level signals
365- [ ] ICP segment deep-dives include Priorities, ICP-fit, Budget & sales cycle, Unique approach, Proof points
366- [ ] Customer names sourced from public references only
367- [ ] Firmographics normalized to standard attributes
368- [ ] VOC quotes are verbatim with source URLs and dates
369- [ ] All evidence includes URL and access date
370- [ ] Confidence levels assigned to all key data
371- [ ] Data gaps documented with follow-up suggestions
Run npx skillmds@latest add gabrielmoreira/icp-research in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Scrapes case studies, testimonials, and solutions pages from a target website to build structured ICP documentation. Produces TAM analysis, firmographic segments, champion and economic buyer personas, use case mapping, customer proof points, and voice-of-customer synthesis with normalized attributes. Requires website URL as primary input. Upstream: recommended company-context. Downstream: feeds positioning, product-messaging, landing-page-copy, content-strategy, and outreach-emails. It is listed under Marketing & Growth on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.