plugins/workflow/skills/buyer-persona/SKILL.md
Use when defining target users, customers, or audience segments to ensure they are grounded in real customer jobs rather than arbitrary demographics.
npx skillsauth add joellewis/skill-library buyer-personaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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?databases
Use when a deliverable needs structured stakeholder sign-off before finalization—runs the pre-read, feedback-type alignment, and conflict-resolution protocol.
development
Use when you need to map who has power, who will be affected, and what motivates each party — produces a stakeholder map as an analytical artifact. This skill identifies and categorizes stakeholders; it does not persuade or influence them (use influence-architect for that).
testing
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
testing
Use when translating a product vision into engineering requirements—enforces the Working Backwards PR/FAQ method, requiring a customer-facing press release before any technical spec.