Agent skill

User Personas

by phuryn in phuryn/pm-skills

Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights.

MITAuto-check passedProduct & Project Management

Install User Personas

skills CLI
$ npx skills add phuryn/pm-skills --skill user-personas -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install phuryn/pm-skills user-personas --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/phuryn/pm-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pm-market-research/skills/user-personas .claude/skills/user-personas && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
user-personas
GitHub stars
27k
Token cost
~762 tokens
SKILL.md length
336 words
Files
1
Skills in repo
67
Repo updated
First seen
Licence
MIT

At a glance

Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights.

  • Works in 5 steps: Data Collection: Read and review all… → Pattern Recognition: Identify recurring… → Segmentation: Group similar users into… → …
  • Building personas from survey data
  • SKILL.md covers Purpose, Instructions and Best Practices
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

User Personas is an agent skill from phuryn/pm-skills. 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.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering User research, User stories and Customer feedback analysis. The repository describes itself as: PM Skills Marketplace: 100+ agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth. The licence is MIT.

When your agent uses it

  • Building personas from survey data
  • Creating user profiles from research
  • Segmenting users for product decisions

Example prompts

  • “/user-personas”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Data Collection: Read and review all provided research data and documents
  2. Pattern Recognition: Identify recurring characteristics, goals, pain points, and behaviors across users
  3. Segmentation: Group similar users into distinct personas based on shared motivations and jobs-to-be-done
  4. Enrichment: For each persona, synthesize data into a coherent profile
  5. Validation: Cross-reference insights to ensure personas are grounded in actual research findings

What it can do on your machine

Read from SKILL.md and the folder at commit 6058e29. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • productcompass.pm

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

User Personas loads about 762 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 336 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~762

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from phuryn/pm-skills at commit 6058e29, republished under its MIT licence (© phuryn). 336 words, ~762 tokens.

Download SKILL.mdSave it as .claude/skills/user-personas/SKILL.md (or your agent's skills folder).
name
user-personas
description
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.

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)
  1. Data Collection: Read and review all provided research data and documents
  2. Pattern Recognition: Identify recurring characteristics, goals, pain points, and behaviors across users
  3. Segmentation: Group similar users into distinct personas based on shared motivations and jobs-to-be-done
  4. Enrichment: For each persona, synthesize data into a coherent profile
  5. 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

© phuryn, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in pm-market-research/skills/user-personas of phuryn/pm-skills.

Open the folder on GitHubat commit 6058e29

Compare with similar skills

User Personas next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

User Personas compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
User Personas this skillphuryn/pm-skills27k—~762Automated safety check: PassMIT
Mom Testwondelai/skills2.4k—~4.2kAutomated safety check: PassMIT
Customer ResearchNexus-JPF/note-companion8706 repos~3.2kAutomated safety check: PassMIT
Design Sprintwondelai/skills2.4k—~3.8kAutomated safety check: PassMIT
Customer Interviewsmenkesu/awesome-pm-skills434—~4.4kAutomated safety check: PassCustom licence
Riffrec Feedback AnalysisEveryInc/compound-engineering-plugin25k—~695Automated safety check: PassMIT

Similar skills

  • Mom Test

    wondelai/skills

    Talk to customers without leading them using Mom Test rules: discuss their life not your idea, ask about specifics in the past, and talk less.

    2.4k GitHub stars~4.2k tokensUpdated 29 days ago
    Product & Project ManagementAuto-check passed
  • Customer Research

    Nexus-JPF/note-companion

    When the user wants to conduct, analyze, or synthesize customer research.

    870 GitHub starsUsed in 6 repos~3.2k tokens
    Marketing & SEOAuto-check passed
  • Design Sprint

    wondelai/skills

    Run a structured 5-day process to prototype, test, and validate product ideas with real users.

    2.4k GitHub stars~3.8k tokensUpdated 29 days ago
    Product & Project ManagementAuto-check passed
  • Customer Interviews

    menkesu/awesome-pm-skills

    Designs customer interviews and turns the transcripts into decisions.

    434 GitHub stars~4.4k tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • Riffrec Feedback Analysis

    EveryInc/compound-engineering-plugin

    Turns Riffrec screen, voice and event recordings into evidence for bug reports and requirements, and helps set up Riffrec when no recording exists yet.

    25k GitHub stars~695 tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Interview Script

    killvxk/pm-skills-zh

    创建结构化的用户访谈脚本,包含 JTBD(用户待办任务)探测问题、破冰环节、核心探索及收尾部分。遵循"老妈测试"原则——不引导、不推销,聚焦过去的实际行为。适用于准备用户访谈、创建访谈指南或规划探索性研究时使用。

    167 GitHub stars~547 tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed

More from phuryn/pm-skills

All 67 skills in this repo
  • Reviews a diff by anchoring on agreements between two sides of a boundary, forcing a concrete violating execution, and refuting each finding before reporting it.

    27k GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • A/B Test Analysis

    phuryn/pm-skills

    Validates an experiment's setup, works out lift, p-value and confidence interval from A/B test data, and recommends whether to ship, extend or stop.

    27k GitHub stars~893 tokensUpdated yesterday
    Auto-check passed
  • Team OKR Brainstorm

    phuryn/pm-skills

    Drafts three alternative sets of team OKRs, each with an inspiring objective and measurable key results, tied to the company strategy you provide.

    27k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Analyzes uploaded cohort data to compute retention curves and feature adoption trends, builds heatmaps and charts, and suggests qualitative follow-up research.

    27k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Dummy Dataset Generator

    phuryn/pm-skills

    Generates realistic test datasets with custom columns, row counts and business constraints, output as CSV, JSON, SQL inserts or a runnable Python script.

    27k GitHub stars~983 tokensUpdated yesterday
    Auto-check passed
  • Grammar and Flow Checker

    phuryn/pm-skills

    Reviews a draft for grammar, logic and flow problems and returns located, prioritized fix suggestions without rewriting the whole text.

    27k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

Questions about User Personas

What does User Personas do?

Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights. User Personas is an agent skill from phuryn/pm-skills. Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights.

When should I use User Personas?

User Personas fits situations like: building personas from survey data; creating user profiles from research; segmenting users for product decisions.

How do I install User Personas in Claude Code?

Run `npx skills add phuryn/pm-skills --skill user-personas -a claude-code`. Or copy the skill folder (pm-market-research/skills/user-personas in phuryn/pm-skills) into .claude/skills/user-personas in your project. Claude Code loads it when a task matches its description.

How do I install User Personas in Codex?

Run `npx skills add phuryn/pm-skills --skill user-personas -a codex`. Or copy the skill folder (pm-market-research/skills/user-personas in phuryn/pm-skills) into .agents/skills/user-personas in your project. Codex loads it when a task matches its description.

Can I use User Personas in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add phuryn/pm-skills --skill user-personas -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/user-personas, .gemini/skills/user-personas, .github/skills/user-personas and .opencode/skills/user-personas in your project.

What does User Personas need to run?

SKILL.md names no scripts, command-line tools or credentials: User Personas is instructions for the agent only.

Does User Personas access the network?

SKILL.md names 1 domain. As links in the text: productcompass.pm. This is read from the text; nothing was executed.

Is User Personas safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does User Personas use?

User Personas is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does User Personas use?

About 762 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to User Personas?

Skills that share tags, products or a category with User Personas: Mom Test (wondelai/skills, 2.4k stars), Customer Research (Nexus-JPF/note-companion, 870 stars), Design Sprint (wondelai/skills, 2.4k stars) and Customer Interviews (menkesu/awesome-pm-skills, 434 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains User Personas?

phuryn (a GitHub user) maintains it in phuryn/pm-skills, which has 26,862 GitHub stars. The repository holds 67 skills in this directory. The repository was last updated on October 9, 2026.

Source: phuryn/pm-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.