icp-builder
Skill723 starsChanged 5 months agoMITView on GitHub
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".
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 7 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 205
After every 50 new customers, after pricing changes, after major features, after new market entry, quarterly minimum.
“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
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.
Other versions8 projects use a version of this.
Word for word · 1
- robertbstillwell/marketing-skills★ 26100% same
Edited · 0
None found.
Wrote their own version · 7
- NEON-Rutger/B2B-revops-skills★ 58same name
- adidacta/pmf-detective★ 18same name
- ilya-a11y/growthband-outbound-skills★ 13same name
- crustdata/skills★ 10same name
- guerrilla2799/marketing-skills★ 9same name
- prosyo-ai/gtm-skill★ 4same name
- veneris-io/outbound-skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository77 other files it gives its agents.
- ab-test-setupSkill
- affiliate-marketingSkill
- ahrefs-pythonSkill
- ai-citations-reportSkill
- generate-imageSkill
- apollo-outreachSkill
- backlink-auditSkill
- blueskySkill
- brand-monitorSkill
- brand-devSkill
- competitor-analysisSkill
- competitor-traffic-reportSkill
- content-calendarSkill
- content-gap-analysisSkill
- content-repurposingSkill
- content-strategySkill
- copy-editingSkill
- copywritingSkill
- demand-genSkill
- discord-botSkill
- domain-researchSkill
- email-sequenceSkill
- email-subject-linesSkill
- facebook-adsSkill
- feishu-larkSkill
- geo-analysisSkill
- geo-difficultySkill
- geo-query-finderSkill
- github-starsSkill
- glasser-researchSkill
- google-ads-reportSkill
- google-adsSkill
- google-analyticsSkill
- google-reviewsSkill
- growth-strategySkill
- gsc-portfolio-auditSkill
- hubspotSkill
- i18nSkill
- keyword-researchSkill
- launch-strategySkill
- lead-magnetSkill
- linkedin-adsSkill
- linkedin-contentSkill
- marketing-ideasSkill
- marketing-slidesSkill
- newsletterSkill
- onboarding-croSkill
- organize-skillsSkill
- page-croSkill
- podcast-editSkill
- podcast-marketingSkill
- pricing-strategySkill
- product-marketingSkill
- programmatic-seoSkill
- publish-articleSkill
- reddit-marketingSkill
- referral-programSkill
- schema-markupSkill
- search-consoleSkill
- semrush-researchSkill
- The first 60 shown.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

