proto-persona — Claude Code skill: user profile
Build a working profile of a target user from research, market signals, and team knowledge. Use it to align early product decisions before deeper validation.
npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a claude-codeWhat proto-persona does
The skill turns available research, analytics, market information, and stakeholder input into a draft user profile. It points to template.md for the fill-in structure and asks the team to mark gaps rather than invent context. The result is a hypothesis, not a research finding.
Use the profile to give early product discussions a shared reference and identify questions for later research. It can also surface conflicting assumptions about who the product is for. Treat the persona as provisional; the skill describes it as something to validate and revise as you learn more.
What it helps with
- align a team on its target user
- combine scattered user signals into a draft profile
- make assumptions about customers explicit
- identify questions for follow-up research
Example prompts for the agent
- Use
proto-personato draft a profile for our target users. - Run
proto-personaon these notes and separate evidence from assumptions. - Use
proto-personato outline a customer hypothesis and questions to validate.
How to install proto-persona
1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a claude-code2Manually: put the files in place
~/.claude/skills/proto-persona/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/proto-persona/
1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a codex2Manually: put the files in place
.agents/skills/proto-persona/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a cursor2Manually: put the files in place
.cursor/skills/proto-persona/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install deanpeters/Product-Manager-Skills proto-persona2Manually: put the files in place
.github/skills/proto-persona/SKILL.md1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a gemini-cli2Platform CLI
gemini skills install https://github.com/deanpeters/Product-Manager-Skills --path skills/proto-personaManually: put the files in place
.devin/skills/proto-persona/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about proto-persona
How do I install proto-persona in Claude Code?
Run npx skills add deanpeters/Product-Manager-Skills --skill proto-persona -a claude-code. The skill file is at ~/.claude/skills/proto-persona/SKILL.md.
What does proto-persona do?
It shapes available research, market signals, and team knowledge into a working hypothesis about a target user. The profile can help align early decisions and point to gaps for further research.
Is a proto-persona a validated user profile?
No. It is an assumption-based starting point, intended to guide later research rather than replace it.