Agent skill

Foundation Persona

by product-on-purpose in product-on-purpose/pm-skills

Generates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract.

Apache-2.0Auto-check passedProduct & Project Management

Install Foundation Persona

skills CLI
$ npx skills add product-on-purpose/pm-skills --skill foundation-persona -a claude-code

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

GitHub CLI
$ gh skill install product-on-purpose/pm-skills foundation-persona --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/product-on-purpose/pm-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/foundation-persona .claude/skills/foundation-persona && 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
foundation-persona
GitHub stars
716
Token cost
~1.1k tokens
SKILL.md length
500 words
Files
5 (incl. references)
Skills in repo
68
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract.

  • Works in 7 steps: Resolve mode and intent → Collect context and evidence → Select exactly one template → …
  • Shaping artifact perspective
  • SKILL.md covers Supported Modes, When to Use, When NOT to Use and Instructions, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Foundation Persona is an agent skill from product-on-purpose/pm-skills. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `HISTORY.md`, `evals/trigger-fixtures.json` and `references/EXAMPLE.md`).

It sits in Product & Project Management, covering Go-to-market strategy and Load testing. The repository describes itself as: 68 plug-and-play, best-practice product management skills for AI agents: 30 Triple Diamond phase + 11 foundation + 12 utility + 15 tool (Foundation Sprint + Design Sprint). Plus… The licence is Apache-2.0.

When your agent uses it

  • Shaping artifact perspective
  • Stress-testing decisions
  • Framing product and GTM strategy

Example prompts

  • “Use the foundation-persona skill to generate an evidence-calibrated product or marketing persona using the canonical v2.5 output contract”
  • “/foundation-persona”

Workflow steps

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

  1. Resolve mode and intent
  2. Collect context and evidence
  3. Select exactly one template
  4. Generate a complete artifact
  5. Enforce mode boundaries
  6. Apply evidence and confidence policy
  7. Finalize for direct use

What it can do on your machine

Read from SKILL.md and the folder at commit 1cef1a9. 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

    No URLs in SKILL.md.

    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

Foundation Persona loads about 1.1k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 500 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

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 product-on-purpose/pm-skills at commit 1cef1a9, republished under its Apache-2.0 licence (© product-on-purpose). 500 words, ~1,120 tokens.

Download SKILL.mdSave it as .claude/skills/foundation-persona/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
foundation-persona
description
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.
license
Apache-2.0
metadata.classification
foundation
metadata.version
2.6.1
metadata.updated
2026-08-16
metadata.category
research
metadata.frameworks
triple-diamond, lean-startup, design-thinking
metadata.author
product-on-purpose
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->

Persona Builder

This skill produces decision-usable personas from one canonical template pack.

Supported Modes

  • product
  • marketing
  • buyer as input alias for marketing (output remains labeled Marketing)

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

When NOT to Use

  • You need the job context rather than the person -> use define-jtbd-canvas; the canvas captures what customers hire products to do, the persona captures who they are
  • You are mapping internal stakeholders, not customers -> use discover-stakeholder-summary
  • You have raw interviews to synthesize first -> use discover-interview-synthesis; a persona built on unsynthesized notes inherits their noise
  • No evidence exists at all and a real decision rides on the persona: gather research first; the skill labels assumptions honestly but cannot substitute for evidence

Instructions

When asked to generate a persona, follow these steps:

  1. Resolve mode and intent Determine whether the request is product or marketing (buyer alias allowed). If mode is omitted, ask for mode selection. If execution must continue without reply, default to product and state that fallback explicitly.

  2. 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.

  3. Select exactly one template Use references/TEMPLATE.md and choose exactly one of:

    • Product Persona Template
    • Marketing Persona Template
  4. Generate a complete artifact Fill the selected template end-to-end:

    • header + one-sentence core-reality statement
    • metadata table
    • Persona Card
    • sections 1 through 11
    • Evidence & Confidence
  5. 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.
  6. Apply evidence and confidence policy

    • Use High|Medium|Low confidence with rationale.
    • Distinguish validated evidence from assumptions.
    • State open questions and governance follow-up.
  7. Finalize for direct use Remove template guidance blockquotes (> notes) from the final output. Ensure narrative entries are concrete and decision-changing, not placeholder bullets.

Show full SKILL.md (122 more words)Show less

Output Contract (v2.5.0)

  • Use one mode only (Product or Marketing) 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
  • buyer inputs are normalized to Marketing
  • Header, core-reality statement, metadata table, and Persona Card are present
  • All 1 through 11 sections 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, or Low with rationale
  • Validated, Assumed, Open questions, and Governance blocks are present
  • Template authoring notes (> guidance lines) are removed from the completed output

Examples

See references/EXAMPLE.md for a completed sample output.

© product-on-purpose, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/foundation-persona of product-on-purpose/pm-skills.

  • SKILL.md
  • HISTORY.md
  • evals/trigger-fixtures.json
  • references/EXAMPLE.md
  • references/TEMPLATE.md

Open the folder on GitHubat commit 1cef1a9

Compare with similar skills

Foundation Persona 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.

Foundation Persona compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Foundation Persona this skillproduct-on-purpose/pm-skills716—~1.1kAutomated safety check: PassApache-2.0
Organic Growth Path Advisordeanpeters/Product-Manager-Skills7.2k2 repos~5.2kAutomated safety check: PassCustom licence
Management ConsultantDogInfantry/claude-skill-management-consultant-B1136—~14kAutomated safety check: PassCustom licence
Solo Business Idea Reviewmanor-os/manor-ai162—~3.1kAutomated safety check: PassCustom licence
Pre Mortemphuryn/pm-skills27k—~1kAutomated safety check: PassMIT
Money Strategyiamzifei/show-me-the-money1k—~7kAutomated safety check: PassCustom licence

Similar skills

  • Organic Growth Path Advisor

    deanpeters/Product-Manager-Skills

    Diagnoses where a growth constraint lives and recommends one organic growth path from the McKinsey Growth Pyramid to test first.

    7.2k GitHub starsUsed in 2 repos~5.2k tokens
    Product & Project ManagementAuto-check passed
  • Management Consultant

    DogInfantry/claude-skill-management-consultant-B1

    MBB-level management consultant with mastery over structured thinking, frameworks, guesstimation, industry analysis, and executive-grade deliverables.

    136 GitHub stars~14k tokensUpdated 20 days ago
    Product & Project ManagementAuto-check passed
  • Solo Business Idea Review

    manor-os/manor-ai

    Audit, compare, and stress-test a one-person business, side project, productized service, digital product, niche software, creator offer, or micro-business idea before major investment.

    162 GitHub stars~3.1k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Pre Mortem

    phuryn/pm-skills

    Run a pre-mortem risk analysis on a PRD or launch plan. An agent skill from phuryn/pm-skills.

    27k GitHub stars~1k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Money Strategy

    iamzifei/show-me-the-money

    Create comprehensive business strategy with premise deconstruction, business model stress test, pricing, go-to-market plan, and competitive positioning.

    1k GitHub stars~7k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Prd V09 Feedback Loop Setup

    mattgierhart/PRD-driven-context-engineering

    Establish channels and processes for capturing and processing post-launch feedback during PRD v0.9 Go-to-Market.

    180 GitHub stars~3.9k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed

More from product-on-purpose/pm-skills

All 68 skills in this repo
  • Define Hypothesis

    product-on-purpose/pm-skills

    Defines a testable hypothesis with clear success metrics and a validation approach.

    716 GitHub stars~966 tokensUpdated 3 days ago
    Auto-check passed
  • Define Jtbd Canvas

    product-on-purpose/pm-skills

    Creates a Jobs to be Done canvas capturing the functional, emotional, and social dimensions of a customer job.

    716 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Define Opportunity Tree

    product-on-purpose/pm-skills

    Creates an opportunity solution tree connecting a desired outcome to customer opportunities and candidate solutions, preventing solution-first jumps in continuous discovery.

    716 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Define Problem Statement

    product-on-purpose/pm-skills

    Creates a clear problem framing document with user impact, business context, and success criteria.

    716 GitHub stars~932 tokensUpdated 3 days ago
    Auto-check passed
  • Deliver Acceptance Criteria

    product-on-purpose/pm-skills

    Generates structured Given/When/Then acceptance criteria for a user story or feature slice, covering the happy path, key failure scenarios, and non-functional expectations in testable form.

    716 GitHub stars~1k tokensUpdated 3 days ago
    Auto-check passed
  • Deliver Launch Checklist

    product-on-purpose/pm-skills

    Creates a cross-functional pre-launch checklist covering engineering, design, marketing, support, legal, and operations readiness, with owners, dates, and go/no-go criteria so nothing is missed…

    716 GitHub stars~970 tokensUpdated 3 days ago
    Auto-check passed

Questions about Foundation Persona

What does Foundation Persona do?

Generates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract. Foundation Persona is an agent skill from product-on-purpose/pm-skills.5 output contract.

When should I use Foundation Persona?

Foundation Persona fits situations like: shaping artifact perspective; stress-testing decisions; framing product and GTM strategy.

How do I install Foundation Persona in Claude Code?

Run `npx skills add product-on-purpose/pm-skills --skill foundation-persona -a claude-code`. Or copy the skill folder (skills/foundation-persona in product-on-purpose/pm-skills) into .claude/skills/foundation-persona in your project. Claude Code loads it when a task matches its description.

How do I install Foundation Persona in Codex?

Run `npx skills add product-on-purpose/pm-skills --skill foundation-persona -a codex`. Or copy the skill folder (skills/foundation-persona in product-on-purpose/pm-skills) into .agents/skills/foundation-persona in your project. Codex loads it when a task matches its description.

Can I use Foundation Persona 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 product-on-purpose/pm-skills --skill foundation-persona -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/foundation-persona, .gemini/skills/foundation-persona, .github/skills/foundation-persona and .opencode/skills/foundation-persona in your project.

What does Foundation Persona need to run?

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

Does Foundation Persona access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Foundation Persona 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 Foundation Persona use?

Foundation Persona is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Foundation Persona use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Foundation Persona?

Skills that share tags, products or a category with Foundation Persona: Organic Growth Path Advisor (deanpeters/Product-Manager-Skills, 7.2k stars), Management Consultant (DogInfantry/claude-skill-management-consultant-B1, 136 stars), Solo Business Idea Review (manor-os/manor-ai, 162 stars) and Pre Mortem (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Foundation Persona?

product-on-purpose (a GitHub organization) maintains it in product-on-purpose/pm-skills, which has 716 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on October 8, 2026.

Source: product-on-purpose/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.