user-personas
Skill0 starsChanged 3 months agoMITView on GitHub
Build user personas from the real people in a company's customer corpus — 3 evidence-backed personas with jobs-to-be-done, pains, gains, and an 'in their own words' verbatim quote block each. Use when the user says 'build personas', 'create user personas', 'who are our users', 'make a persona for X', 'segment our users into profiles', or wants research-backed profiles instead of invented archetypes. Trigger terms: personas, user persona, buyer persona, who are our users, JTBD profiles, user archetypes. Not for fictional marketing avatars invented without evidence.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- miguelclavel/ux-research-skillstheir own version, first seen Nov 8, 2026
- alunadev/ald-skillstheir own version, first seen Nov 8, 2026
- yuusakuri/agent-skillstheir own version, first seen Nov 1, 2026
- daviszhen/agent-skillstheir own version, first seen Oct 25, 2026
- stefanomartiradonna/claude-skillstheir own version, first seen Aug 14, 2026
- Adhamxon/claude-code-skillstheir own version, first seen Jul 30, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- alunadev/ald-skills★ 4same name
- Adhamxon/claude-code-skills★ 2same name
- skytiger6724/qwen-skills★ 2same name
- yuusakuri/agent-skills★ 2same name
- daviszhen/agent-skills★ 1same name
- miguelclavel/ux-research-skills★ 1same name
- miovrag/claude-skills★ 1same name
- maeng777/claude-skills★ 0same name
- stefanomartiradonna/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository44 other files it gives its agents.
- analyze-feature-requestsSkill
- assumptionsSkill
- beachhead-segmentSkill
- brainstorm-ideasSkill
- brainstorm-okrsSkill
- business-modelSkill
- competitive-battlecardSkill
- competitor-analysisSkill
- create-prdSkill
- customer-journey-mapSkill
- customer-researchSkill
- daily-briefSkill
- deep-diveSkill
- development-planSkill
- gap-analysisSkill
- gtm-strategySkill
- ideal-customer-profileSkill
- initial-reportSkill
- interview-scriptSkill
- list-capabilitiesSkill
- market-sizingSkill
- north-star-metricSkill
- opportunity-solution-treeSkill
- outcome-roadmapSkill
- positioning-and-messagingSkill
- pricing-strategySkill
- prioritize-featuresSkill
- product-strategySkill
- product-visionSkill
- release-notesSkill
- review-prSkill
- schedule-new-ingestion-tasksSkill
- segmentationSkill
- sentiment-analysisSkill
- setup-evermuseSkill
- shipping-artifactsSkill
- strategy-frameworksSkill
- strategy-red-teamSkill
- summarize-conversationSkill
- test-scenariosSkill
- user-storiesSkill
- using-evermuseSkill
- value-propositionSkill
- write-feature-specSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 9 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 29
Required — one parallel batch of searches: Verify the product (Rule 1), then fire in a single parallel batch:
- Distinctive: line 45
Validate: Every attribute must trace to something a real person said or did.
“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
User Personas (from real people, not archetypes)
Produce 3 personas that a skeptical stakeholder can't dismiss as made up — because every trait, pain, and goal traces to a real person who appears in the Evermuse corpus, and each persona carries a block of that person's own words. A persona nobody in the corpus resembles is a failure of this skill.
Step 0 — Relevance & availability
Confirm this is user/customer profiling work and Evermuse is connected (see using-evermuse Step 0). If the MCP isn't connected, produce framework-only personas labeled ⚠ ungrounded — Evermuse not connected and tell the user to authorize the MCP. Never present invented archetypes as research-backed.
Evermuse Grounding (required)
Follow ${CLAUDE_PLUGIN_ROOT}/skills/using-evermuse/SKILL.md.
Required — one parallel batch of searches. Verify the product (Rule 1), then fire in a single parallel batch:
- 3–4
evidencesearches, each worded from a different angle (limitup to 50). Evidence comes back rich and varied — expect large, useful result sets. - one
guidancesearch and onecontextsearch (limitup to 50). These are usually sparse or empty; run them anyway and note when they're thin. - one
find_sourcesbrowse (noquery,limitup to 50) to map who actually exists in the corpus — theparticipants, attendees, accounts, and domains across sources. To pull everything one person or one account said, re-runfind_sourceswithparticipant(name or email) orattendee_domain. Personas are composites of these real people; this call is the raw material for Instructions step 1.
Read each response's digest — it reports how many more results exist. Use judgment on whether a query is worth pulling deeper (raise limit toward the 100 max and/or page with next_offset to avoid repeats), weighing payload size, remaining context, task complexity, and the value of the data. For deep pulls, consider spawning sub-agents — instruct them to return every citation with the same metadata the tools return (url, who_said_it, meeting_name, created_at) so you can still cite.
Optional — considered use. Once grounded, reach for the other tools only when they add value: a quote-angled search for verbatim voice, read_source for a single deep dive, inline citations (references/citations.md), and add_source to save the deliverable. Sources, citations, and saving are optional — not required.
Instructions
Build 3 refined personas for $ARGUMENTS, grounded entirely in the corpus.
- Map who's really there. From
find_sources, list the distinct people/accounts. This is your raw material — personas are composites of these real users, not personas you'd expect the market to have. - Cluster by job and behavior. Group the real people by shared jobs-to-be-done, workflows, and motivations. Distinct needs, not distinct age brackets. Aim for 3 non-overlapping personas; if the corpus only supports 2, say so rather than padding.
- Enrich each persona from evidence, using the structure below. Where the source method would reach for a survey or "if the user provides data", reach for
evidencesearches and a quote-angledsearchinstead. - Validate. Every attribute must trace to something a real person said or did. Flag any trait you're inferring vs. one that's directly evidenced.
Persona structure (each of the 3)
Name & snapshot — a memorable label + role/context (the composite of who this represents in the corpus).
Primary job-to-be-done — the core outcome they're trying to achieve, with context and frequency, drawn from what they described.
Top 3 pains — each a real obstacle, each badged with the account(s) it came from and severity.
Top 3 gains — the outcomes they seek and how they'd measure success.
One unexpected insight — a counterintuitive pattern the evidence reveals, and why it matters for the product.
In their own words (required) — a block of 2–4 verbatim quotes from real people in this cluster:
> "[verbatim quote]" — [Name], [Meeting], [Date] [`1`](URL)
> "[verbatim quote]" — [Name], [Meeting], [Date] [`2`](URL)Product fit — how $ARGUMENTS serves (or fails) this persona, with the friction points evidenced.
End with a one-line honesty note if any persona rests on thin evidence (e.g. "Persona C: only 2 accounts — validate with more interviews"). Offer /evermuse:customer-research to go deeper on any one persona.
Further reading
- Persona method adapted from phuryn/pm-skills (MIT); grounding is Evermuse-native. See also the JTBD Masterclass.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

