From workflow
Use when defining target users, customers, or audience segments to ensure they are grounded in real customer jobs rather than arbitrary demographics.
How this skill is triggered — by the user, by Claude, or both
Slash command
/workflow:buyer-personaThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill forces the creation of personas grounded in functional objectives (Jobs-to-be-Done) rather than superficial demographics. By focusing on the *Job Performer* and their *Struggling Moments*, it ensures that product and marketing efforts address actual customer needs.
This skill forces the creation of personas grounded in functional objectives (Jobs-to-be-Done) rather than superficial demographics. By focusing on the Job Performer and their Struggling Moments, it ensures that product and marketing efforts address actual customer needs.
NO PERSONA WITHOUT A VALIDATED JOB-TO-BE-DONE
Personas built on demographics alone (e.g., "Millennial Mark") lead to "fluffy" marketing and products that fail to solve real problems. A persona must be anchored to a specific job someone is trying to "hire" a solution for.
digraph buyer_persona_flow {
"Discovery: Interviews" [shape=doublecircle];
"Step 1: Identify Job Performer" [shape=box];
"Step 2: Define Main Job & Needs" [shape=box];
"Gate: Validated Job?" [shape=diamond];
"Step 3: Layer Psychographics" [shape=box];
"Step 4: Draft PR/FAQ" [shape=box];
"Persona Approved" [shape=doublecircle];
"Discovery: Interviews" -> "Step 1: Identify Job Performer";
"Step 1: Identify Job Performer" -> "Step 2: Define Main Job & Needs";
"Step 2: Define Main Job & Needs" -> "Gate: Validated Job?";
"Gate: Validated Job?" -> "Step 3: Layer Psychographics" [label="validated"];
"Gate: Validated Job?" -> "Discovery: Interviews" [label="fuzzy"];
"Step 3: Layer Psychographics" -> "Step 4: Draft PR/FAQ";
"Step 4: Draft PR/FAQ" -> "Persona Approved";
}
market-context or stakeholder-discovery).Distinguish between the Job Performer (the person doing the work) and the Buyer (the person with the budget). A successful persona prioritizes the needs of the performer first to ensure product-market fit. (Source: Kalbach, Ch. 2)
Use the standard syntax: verb + object + clarifier.
Direction + Measure + Object + Clarifier (e.g., Minimize the time it takes to share learnings).Identify the Circumstances (time, manner, place) that trigger the job.
Use the STAR method (Situation, Task, Action, Result) to drill into past behaviors. Do not ask for future preferences; ask for the last time they struggled with the job. (Source: Constable, Bryar)
Write a customer-facing press release and a set of internal/external FAQs for this persona. If the "Press Release" doesn't excite the defined persona, the persona or the product is wrong. (Source: Bryar, Ch. 5)
REQUIRED SUB-SKILL: stakeholder-discovery — to identify all actors in the ecosystem (approvers, technicians). RECOMMENDED SUB-SKILL: prd-writing — to turn the persona's needs into a formal requirements document.
| Thought | Reality |
|---|---|
| "We already know our audience is 25-35 year old men." | Demographics don't predict behavior; struggling moments do. |
| "Writing a PR/FAQ is too much work for a simple persona." | If you can't write a compelling PR, you don't understand the persona's pain. |
| "Let's just ask them what features they want." | It's the customer's job to explain the problem; it's yours to design the solution. |
| "This persona is for 'everyone'." | A product for everyone is a product for no one. Proudly exclude. |
These thoughts mean STOP — you are about to shortcut:
verb + object + clarifier syntax?npx claudepluginhub joellewis/skill-library --plugin workflowCreates behavioral personas, ideal customer profiles (ICP), and applies Jobs-to-be-Done framework using user interview techniques. Generates MY-ICP.md for other skills.
Builds interactive user personas by researching audiences via web searches/fetches, profiling demographics/behaviors/motivations, and linking to product features/user stories.
Use this skill when the user asks to "create user personas", "develop personas", "write a persona", "define our users", "user profile", "who is our user", "help me define the target user", "create a user archetype", or wants to build or update structured user persona definitions grounded in research or known user characteristics.