one-pager-prd — Claude Code skill: what it does, how to install
one-pager-prd is a Claude Code skill that turns a feature idea into a one-page spec or PRD with its problem, solution, users, metrics, and scope, before detailed design or development.
no license 125 installs ★ 203 updated 2026-09-01
npx skills add lyndonkl/claude --skill one-pager-prd -a claude-codeWhat one-pager-prd does
The skill guides the author from gathering context to reviewing a draft. It prompts for the user problem, target audience, high-level approach, success measures, and project constraints. Small features get a brief one-page format; more involved work can use a fuller PRD with requirements and user flows.
The output is one-pager-prd.md. It covers goals and measurable targets, included and excluded work, assumptions, and unresolved questions. The skill draws on a template, writing guidance, and a JSON rubric to assess the draft; the stated minimum average score is 3.5.
It also calls for stakeholder feedback and approval before detailed design or development. This is not the suggested format for technical design documents: the guidance points to ADRs for those.
What it helps with
- turn a feature idea into a concise spec
- spell out the problem and intended users
- set measurable goals and target values
- separate MVP scope from later work
- prepare open questions for stakeholder review
Example prompts for the agent
- Draft a one-page spec for this feature and save it as
one-pager-prd.md. - Write a PRD for the project with user flows, success measures, and scope boundaries.
- Assess this product spec with the quality rubric and list the questions it leaves open.
How to install one-pager-prd
1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill one-pager-prd -a claude-code2Manually: put the files in place
~/.claude/skills/one-pager-prd/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/one-pager-prd/
1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill one-pager-prd -a codex2Manually: put the files in place
.agents/skills/one-pager-prd/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill one-pager-prd -a cursor2Manually: put the files in place
.cursor/skills/one-pager-prd/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lyndonkl/claude skills/one-pager-prd2Manually: put the files in place
.github/skills/one-pager-prd/SKILL.md1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill one-pager-prd -a gemini-cli2Platform CLI
gemini skills install https://github.com/lyndonkl/claude --path skills/one-pager-prdManually: put the files in place
.devin/skills/one-pager-prd/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill one-pager-prd -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 one-pager-prd
How do I install one-pager-prd in Claude Code?
Run npx skills add lyndonkl/claude --skill one-pager-prd -a claude-code. The skill file is placed at ~/.claude/skills/one-pager-prd/SKILL.md.
What does one-pager-prd do?
It guides the creation of a one-page feature spec or a fuller PRD, covering the problem, proposed approach, users, metrics, scope, constraints, and unresolved questions.
What does the skill use to assess a PRD?
It checks the draft against resources/evaluators/rubric_one_pager_prd.json. The supporting template and writing guidance are in resources/template.md and resources/methodology.md.