customer-research
Use this skill when the user needs to understand their customers, create personas, conduct user interviews, apply the Jobs-to-be-Done framework, or create an ideal customer profile. Also use when the user says 'ICP,' 'ideal customer,' 'who is my customer,' 'customer profile,' or 'target audience.' Covers JTBD methodology, behavioral personas, interview techniques, and creates MY-ICP.md — a reference file that other skills use to personalize copy with customer language.
What this skill does
# Customer Research & Personas Personas based on demographics are useless. Personas based on behaviors, goals, and constraints drive decisions. This skill helps you run interviews, apply Jobs-to-be-Done, and build personas that actually inform your product. ## Core Principles - Personas based on demographics are useless. "34-year-old male marketer" tells you nothing about product design. - Personas based on behaviors, goals, and constraints drive decisions. - The goal of research is to discover what users DO, not what they SAY they want. - Five good interviews reveal 80% of usability issues. - Jobs-to-be-Done > traditional personas for SaaS product decisions. ## Jobs-to-be-Done Framework A "job" is the progress a user is trying to make in a specific circumstance. **Job statement format:** "When I [situation], I want to [motivation], so I can [desired outcome]." **Examples:** - "When I'm preparing for a board meeting, I want to pull together our key metrics quickly, so I can spend my time on the narrative, not the data." - "When a new developer joins our team, I want to get them productive on day one, so I can maintain our shipping velocity." **Discover jobs by asking:** 1. "Walk me through the last time you [did the thing]." 2. "What were you trying to accomplish?" 3. "What did you try first? What happened?" 4. "What was frustrating about that?" 5. "What would 'good enough' look like?" 6. "What would 'amazing' look like?" ## Behavioral Persona Template ```markdown ## [Persona Name] — [One-line role description] ### Behavioral Segment What behavior defines this group? (e.g., "Uses the product daily for team coordination" or "Evaluates tools quarterly for the team") ### Primary Job [Job statement in JTBD format] ### Context - Role and responsibilities (relevant to product usage) - Team size and structure - Tools they use alongside yours - Technical sophistication level - Decision-making authority (buyer, influencer, user) ### Current Workflow (without your product) Step-by-step: How do they accomplish this job today? Where are the friction points? ### Key Pain Points 1. [Specific, observed pain — not assumed] 2. [Another specific pain] 3. [Another specific pain] ### Success Criteria How do they measure whether the job is done well? What would make them say "this is working"? ### Objections / Barriers to Adoption What would prevent them from trying or buying? ### Trigger Events What circumstances push them to seek a new solution? (Team growth, tool sunset, new mandate, frustration peak) ``` ## User Interview Guide **Before the interview:** - Define your learning goal: What decision will this inform? - Recruit based on behavior, not demographics. - 5-8 interviews per persona segment is usually sufficient. **Opening (2 min):** "Thanks for joining. I'm trying to understand how people [do X]. There are no right answers — I'm learning from your experience. Can I ask you some questions about how you currently handle [topic]?" **Core questions (25 min):** 1. "Tell me about your role. What does a typical week look like?" 2. "When was the last time you [relevant task]? Walk me through it." 3. "What tools do you use for this? How did you end up with those?" 4. "What's the most frustrating part of this process?" 5. "If you could wave a magic wand and fix one thing, what would it be?" 6. "Have you tried other solutions? What happened?" 7. "Who else is involved in this process?" 8. "How do you decide when to invest in a new tool for this?" **Closing (3 min):** "Is there anything about [topic] I should have asked but didn't?" "Would you be open to trying an early version and giving feedback?" ## When You ARE the Persona If you're building for your own profession, you have a unique advantage and a unique blind spot. **The advantage:** You understand the pain deeply. You don't need to "discover" the problem — you've lived it. **The blind spot:** You assume everyone does the job the way you do. They don't. After 20 years, your workflow is optimized. A 3-year practitioner's workflow is different. A solo practitioner's is different from someone at a large firm. **How to correct for this:** - Interview people at different experience levels (junior, mid, senior) - Interview people at different organization sizes (solo, small firm, large firm) - When they describe their process and it's different from yours, don't correct them. That's data. - Ask: "What tools do you actually use?" — not "Would you use a tool that does X?" - The question isn't "Do I have this pain?" — it's "Do enough OTHER people have it, and will they pay?" --- ## Interview Analysis After interviews, synthesize: 1. **Common patterns:** What did 3+ people say independently? 2. **Surprising insights:** What contradicted your assumptions? 3. **Exact quotes:** Capture the user's words, not your interpretation. 4. **Pain intensity:** Rate each pain point (annoying vs. hair-on-fire). 5. **Willingness to pay:** Would they pay to solve this? How much? ## Turning Research into Action Research is only valuable if it changes decisions: - **Feature prioritization:** "Persona A's #1 pain is X, which maps to feature Y." - **Messaging:** Use their exact words in marketing copy. - **Onboarding:** Design the first-run experience around their primary job. - **Pricing:** Align tiers with persona segments. - **Roadmap:** Sequence features by persona priority. --- ## Capture Your ICP: Create MY-ICP.md Research is useful in the moment. `MY-ICP.md` makes it useful forever. This file captures who your customer is so every other skill — landing pages, ads, email, pricing copy — can use their language instead of your marketing language. ### When to create it - After completing interviews and synthesizing findings - After building behavioral personas above - Or right now, if you're a domain expert who already knows your customer deeply ### Quick capture for domain experts If you ARE your customer (or were recently), you can skip interviews and write this directly. But be honest about your blind spots — the "When You ARE the Persona" section above still applies. > Describe your ideal customer. Be specific about who they are, what frustrates them, what they're trying to accomplish, how they make buying decisions, and what words they actually use when talking about this problem. If you have multiple customer types, describe each one — start with your primary. ### After interviews Pull from your Interview Analysis above: - **Exact quotes** become the "Their Language" section - **Common patterns** become "Their Pain" and "Their Goals" - **Pain intensity** informs priority within sections ### MY-ICP.md template ```markdown # My Ideal Customer Profile ## Primary ICP: [Name or label — e.g., "Solo Consultants" or "Marketing Managers at Series A startups"] ### Who They Are [Role, company size, experience level, relevant demographics. Not a persona — specific enough that you could find them on LinkedIn.] ### Their Pain [Primary problems, current workarounds, what frustrates them. Use THEIR words, not your marketing language. Example: "I spend 3 hours every Monday pulling reports from 4 different tools" not "inefficient multi-platform reporting workflows."] ### Their Goals [What success looks like to them. What they're trying to achieve. The outcome they'd pay for, in their framing.] ### How They Buy [Decision process — do they decide alone or need approval? Common objections. Price sensitivity. What triggers a purchase. What makes them say no.] ### Their Language [Actual words and phrases they use to describe the problem. Pull directly from interviews, Reddit posts, reviews, support tickets. This section is gold for landing pages, ads, and email subject lines.] ### Where They Are [Communities, publications, events, Slack groups, subreddits, LinkedIn groups. Where you can reach them. Where they go for advice.] --- ## Secondary ICP: [Name or label] (if applicable) [Same sections as abov
Related in Writing & Docs
jax-development
IncludedUse this skill when the user is writing, debugging, profiling, refactoring, reviewing, benchmarking, parallelising, exporting, or explaining JAX code, or when they mention JAX, jax.numpy, jit, grad, value_and_grad, vmap, scan, lax, random keys, pytrees, jax.Array, sharding, Mesh, PartitionSpec, NamedSharding, pmap, shard_map, Pallas, XLA, StableHLO, checkify, profiler, or the JAX repo. It helps turn NumPy or PyTorch-style code into pure functional JAX, fix tracer/control-flow/shape/PRNG bugs, remove recompiles and host-device syncs, choose transforms and sharding strategies, inspect jaxpr/lowering/IR, and benchmark compiled code correctly.
nature-article-writer
IncludedDrafts, rewrites, diagnostically critiques, and style-calibrates primary research manuscripts for Nature and Nature Portfolio journals. Use when the user wants a Nature-style title, summary paragraph or abstract, introduction, results, discussion, methods, figure legends, presubmission enquiry, cover letter, reviewer response, or when a scientific draft sounds generic, jargon-heavy, structurally weak, or AI-ish and needs precise, broad-reader-friendly prose without inventing data, analyses, or references. Best for primary research articles and letters rather than reviews or press releases unless explicitly adapting one.
deckrd
IncludedDocument-driven framework that derives requirements, specifications, implementation plans, and executable tasks from goals through structured AI dialogue. Use when user says "write requirements", "create spec", "plan implementation", "derive tasks", "structure this feature", "break down into tasks", or "document this module". Also use for reverse engineering existing code into docs (/deckrd rev). Do NOT use for direct code writing — use /deckrd-coder after tasks are generated. Do NOT use when the user only wants to run or fix existing code without planning.
clinical-decision-support
IncludedGenerate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
handling-sf-data
IncludedSalesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records using sf CLI and anonymous Apex. TRIGGER when: user creates test data, performs bulk import/export, uses sf data CLI commands, needs data factory patterns for Apex tests, or needs to seed/clean records in a Salesforce org. DO NOT TRIGGER when: SOQL query writing only (use querying-soql), Apex test execution (use running-apex-tests), or metadata deployment (use deploying-metadata).
accelint-ac-to-playwright
IncludedConvert and validate acceptance criteria for Playwright test automation. Use when user asks to (1) review/evaluate/check if AC are ready for automation, (2) assess if AC can be converted as-is, (3) validate AC quality for Playwright, (4) turn AC into tests, (5) generate tests from acceptance criteria, (6) convert .md bullets or .feature Gherkin files to Playwright specs, (7) create test automation from requirements. Handles both bullet-style markdown and Gherkin syntax with JSON test plan generation and validation.