
buyer-persona
Use when defining target users, customers, or audience segments to ensure they are grounded in real customer jobs rather than arbitrary demographics.
- Installs
- 41
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/joellewis/skill-library --skill buyer-persona- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads buyer-persona automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Overview
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.
Iron Law
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.
State Machine
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";
}
When to Use This Skill
- When starting a new product or feature.
- When existing marketing messages are not resonating.
- When the team is confused about who the "ideal customer" really is.
- When user research identifies a recurring "struggling moment."
When NOT to Use This Skill
- For purely technical internal optimizations.
- When the "who" is a legal entity (use
market-contextorstakeholder-discovery).
Core Process
Step 1: Identify the Job Performer
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)
Step 2: Define the Main Job & Needs
Use the standard syntax: verb + object + clarifier.
- Main Job: The overarching functional objective (e.g., Visit family on special occasions).
- Needs: Desired outcomes expressed as
Direction + Measure + Object + Clarifier(e.g., Minimize the time it takes to share learnings). - Iron Law Check: Ensure the job is solution-agnostic. Can they do this job without your product? (Source: Kalbach, Ch. 2)
Step 3: Layer Psychographics & Circumstances
Identify the Circumstances (time, manner, place) that trigger the job.
- Pushes/Pulls: What is pushing them away from their current solution? What is pulling them toward a new one?
- Anxieties/Habits: What worries them about changing? What old habits keep them stuck? (Source: Lenny's Newsletter / Bob Moesta)
- Proudly Exclude: Identify who the persona is not. Confidently exclude 99% of the market to win the "Hell Yeah!" 1%. (Source: Sivers, Ch. 16)
Step 4: Validate with Stories (The Truth Curve)
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)
Step 5: Draft the PR/FAQ
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)
Cross-Skill Invocations
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.
Rationalization Table
| 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. |
Red Flags
These thoughts mean STOP — you are about to shortcut:
- "The persona is 'The Enterprise Buyer'" → You've ignored the Performer.
- "Our job is 'Use [Product Name] to...'" → You've embedded the solution into the job.
- "We'll build it first and find the persona later" → This is the #1 cause of product failure.
Diagnostic Checklist
- Is the "Main Job" defined using
verb + object + clarifiersyntax? - Is the "Job Performer" distinct from the "Buyer"?
- Have we identified the "Struggling Moment" that triggers the job?
- Does the persona confidently exclude a large portion of the market?
- Is every claim in the persona backed by a past-behavior story (STAR method)?
Sources
- Kalbach, Jim. The Jobs to Be Done Playbook. Ch. 2, 4.
- Constable, Giff. Talking to Humans. "How To," "The Truth Curve."
- Bryar, Colin. Working Backwards. Ch. 5 (PR/FAQ).
- Sivers, Derek. Anything You Want. Ch. 16.
- Richardson, Bailey. Get Together. "Spark the Flame."
- Lenny's Newsletter. "Persona Methodology with Bob Moesta."
FAQ
What does the buyer-persona skill do?
Use when defining target users, customers, or audience segments to ensure they are grounded in real customer jobs rather than arbitrary demographics.
How do I install buyer-persona?
Run npx skills add https://github.com/joellewis/skill-library --skill buyer-persona in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/buyer-persona/ (personal) or .claude/skills/buyer-persona/ (project).
Which AI agents can use buyer-persona?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is buyer-persona safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains buyer-persona?
It is published by joellewis in joellewis/skill-library. It has 41 recorded installs.
More from joellewis/skill-library
fiction-architect
joellewis/skill-library
Designs plot structure and story arcs using McKee's value turns, Campbell's monomyth, and Sanderson's Promise/Progress/Payoff model to ensure causal integrity and emotional resonance. Use when constructing narratives, outlining novels, or diagnosing why a story feels broken.
dialogue-craft
joellewis/skill-library
Writes and refines dialogue that serves plot and reveals character through subtext, intention, and behavioral exchange — applying McKee's subtext principle and Sorkin's intention-and-obstacle model. Use when dialogue feels flat, expository, or 'on the nose.'
world-building-logic
joellewis/skill-library
Engineers internally consistent fictional worlds using Brand's Pace Layers for social structure and Sanderson's Laws of Magic for system constraints. Use when building settings, designing magic or tech systems, or auditing a world for logical contradictions.
character-vulnerability
joellewis/skill-library
Use when a character feels flat, too competent, or unrelatable—identifies the Sacred Flaw (Storr's Theory of Control) and dials the Three Sliders (Sanderson) to create earned vulnerability.
problem-framing
joellewis/skill-library
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
one-pager
joellewis/skill-library
Use when compressing a complex strategy or analysis into a strictly one-page narrative—enforces Pyramid SCQ structure and Orwell word-budget discipline.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.