Agent skill
foundation-persona
Generates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract. Use when shaping artifact perspective, stress-testing decisions, or framing product and GTM strategy.
Install this agent skill to your Project
npx add-skill https://github.com/product-on-purpose/pm-skills/tree/main/skills/foundation-persona
Metadata
Additional technical details for this skill
- author
- product-on-purpose
- category
- research
- frameworks
-
[ "triple-diamond", "lean-startup", "design-thinking" ]
SKILL.md
Persona Builder
This skill produces decision-usable personas from one canonical template pack.
Supported Modes
productmarketingbuyeras input alias formarketing(output remains labeledMarketing)
Generated agent mode is out of scope for v2.5.0.
If the user asks for agent, ask them to choose product or marketing.
When to Use
- Before drafting PM or GTM artifacts that need a clear persona viewpoint
- When teams disagree on priorities and need behavior-grounded tradeoff framing
- When assumptions and confidence levels must be explicit for decision review
- When tailoring downstream work (PRD, stories, launch, messaging, enablement) to a specific user or buyer profile
Instructions
When asked to generate a persona, follow these steps:
-
Resolve mode and intent Determine whether the request is
productormarketing(buyeralias allowed). If mode is omitted, ask for mode selection. If execution must continue without reply, default toproductand state that fallback explicitly. -
Collect context and evidence Use user-provided context first (goals, audience, domain, constraints, sources). If evidence is thin, continue generation but mark gaps and calibrate confidence.
-
Select exactly one template Use
references/TEMPLATE.mdand choose exactly one of:Product Persona TemplateMarketing Persona Template
-
Generate a complete artifact Fill the selected template end-to-end:
- header + one-sentence core-reality statement
- metadata table
Persona Card- sections
1through11 Evidence & Confidence
-
Enforce mode boundaries
- Product mode: focus on workflow behavior, decision patterns, friction, quality bar, and product tradeoffs.
- Marketing mode: focus on buying triggers, evaluation criteria, committee dynamics, objections, messaging, and GTM implications.
-
Apply evidence and confidence policy
- Use
High|Medium|Lowconfidence with rationale. - Distinguish validated evidence from assumptions.
- State open questions and governance follow-up.
- Use
-
Finalize for direct use Remove template guidance blockquotes (
>notes) from the final output. Ensure narrative entries are concrete and decision-changing, not placeholder bullets.
Output Contract (v2.5.0)
- Use one mode only (
ProductorMarketing) per output. - Keep section numbering and headings from the selected template.
- Preserve the evidence table plus validated/assumed/open-questions/governance blocks.
Quality Checklist
Before finalizing, verify:
- Exactly one mode is used and clearly labeled
-
buyerinputs are normalized toMarketing - Header, core-reality statement, metadata table, and
Persona Cardare present - All
1through11sections from the selected template are present and complete - Includes/not-valid boundaries are explicit in the metadata and narrative
- Evidence table is populated with concrete sources
- Confidence is
High,Medium, orLowwith rationale -
Validated,Assumed,Open questions, andGovernanceblocks are present - Template authoring notes (
>guidance lines) are removed from the completed output
Examples
See references/EXAMPLE.md for a completed sample output.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
init-project
Initialize projects with agentic coding structure. Use when setting up a new project, adding AI agent support to existing project, or when user says "init", "initialize", "setup project", or "scaffold". Creates AGENTS folder, documentation templates, and _NOTES scratch space.
init-project-jpkb
Initialize new JPKB projects with standardized documentation and folder structure. JPKB-specific version with category folders and fixed base path. Use when creating a new project in the jpkb repository, when the user says "init project", "new project", or when the target is the JPKB projects folder.
wrap-session
End-of-session documentation workflow that updates README, CHANGELOG, agent context files, and creates session logs. Use when wrapping up a working session, when asked to document session progress, when preparing handoff documentation, or when the user says "wrap up", "end session", "document progress", or "save session".
skill-template
utility-update-pm-skills
Checks for newer pm-skills releases, compares local vs. latest version, previews what would change, and updates local files after user confirmation. Generates a structured update report documenting changed files, new capabilities, and the value delta between versions. Use when you want to bring a local pm-skills installation up to date.
utility-update-pm-skills
Validates internet access, compares the locally installed pm-skills version against the latest public release, and updates local files with conflict-aware overwrite-or-skip options. Produces an update report listing changed files, skipped files, and new capabilities. Use when you want to bring a local pm-skills installation up to date.
Didn't find tool you were looking for?