phuryn
Install User Personas
Pick your agent. Every command is ready to paste.
npx skills add phuryn/pm-skills --skill user-personasThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads user-personas when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the user-personas skill”. In Codex, type $user-personas.
The skill itself
SKILL.md
User Personas
Purpose
Create detailed, actionable user personas from research data that capture the true diversity of your user base. This skill generates research-backed personas with jobs-to-be-done, pain points, desired outcomes, and unexpected behavioral insights to guide product decisions.
Instructions
You are an experienced product researcher specializing in persona development and user research synthesis.
Input
Your task is to create 3 refined user personas for $ARGUMENTS.
If the user provides CSV, Excel, survey responses, interview transcripts, or other research data files, read and analyze them directly using available tools. Extract key patterns, demographics, motivations, and behaviors.
Analysis Steps (Think Step by Step)
- Data Collection: Read and review all provided research data and documents
- Pattern Recognition: Identify recurring characteristics, goals, pain points, and behaviors across users
- Segmentation: Group similar users into distinct personas based on shared motivations and jobs-to-be-done
- Enrichment: For each persona, synthesize data into a coherent profile
- Validation: Cross-reference insights to ensure personas are grounded in actual research findings
Output Structure
For each of the 3 personas, provide:
Persona Name & Demographics
- Age range, role/title, company size (if B2B), key characteristics
Primary Job-to-be-Done
- The core outcome the persona is trying to achieve
- Context and frequency of the job
Top 3 Pain Points
- Specific challenges or obstacles preventing job completion
- Impact and severity of each pain
Top 3 Desired Gains
- Benefits, outcomes, or solutions the persona seeks
- How they measure success
One Unexpected Insight
- A counterintuitive behavioral pattern or motivation derived from the data
- Why this matters for product decisions
Product Fit Assessment
- How $ARGUMENTS addresses (or could address) this persona's needs
- Potential friction points or unmet needs
Best Practices
- Ground all insights in actual data; avoid assumptions
- Use direct quotes from research when available
- Identify behavioral patterns, not just demographic categories
- Make personas distinct and non-overlapping where possible
- Flag any data gaps or areas requiring additional research
Further Reading
Tips for User Personas
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 40 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about User Personas
What does the User Personas skill do?
Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights. Use when building personas from survey data, creating user profiles from research, or segmenting users for product decisions.
How do I install User Personas?
Run "npx skills add phuryn/pm-skills --skill user-personas" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does User Personas work in Cursor and Codex?
Yes. User Personas uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is User Personas free?
User Personas is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made User Personas?
User Personas is published by phuryn in the phuryn/pm-skills repository, together with 39 other skills.
