
pm-requirements
Write market-driven, prioritized product requirements (a Market Requirements Document / MRD) the Pragmatic Institute way. Use when the PM asks for "requirements", "an MRD", "what should we build", "prioritize features", "market requirements", or wants development to stop saying "requirements aren't specific enough". Articulates each requirement as a persona's problem, prioritizes with Market Evidence × Impact, and groups them for delivery. Produces a Market Requirements Document as a Markdown or Word .docx artifact.
- Installs
- 40
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/julianoczkowski/product-manager --skill pm-requirements- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads pm-requirements automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Market Requirements (Pragmatic Framework: Planning → Requirements)
Rule: market problems drive requirements that work. A requirement articulates a problem, not a solution — the what (owned by the PM), never the how (owned by the team). Write every requirement as:
[persona] has [problem, described in a use scenario] with [frequency].
If personas or use scenarios aren't ready, run pm-personas and pm-use-scenarios first.
See ../pm-copilot/references/framework.md.
Prioritize objectively (never High/Med/Low or voting)
Priority = Market Evidence × Impact.
- Market Evidence — a tally of documented occurrences across inputs (discovery interviews, surveys, sales calls, support tickets, win/loss, analyst reports, reviews, usage data). "How many times have we seen it? What % experience it?"
- Impact — an objective 1–5 scale (adapt to your strategy) plus a 99999 contractual override:
| Impact | Definition |
|---|---|
| 99999 | Contractual obligation |
| 5 | Minimum purchase criteria (evaluator) |
| 4 | Potentials lose time or money due to the problem |
| 3 | Difficult for customers to achieve a primary goal |
| 2 | Customers have difficulty with a non-primary goal |
| 1 | Not in the target market segment |
Advanced — the Four Forces (BUVC):
Priority = Evidence × Impact × (B + U + C + V) Buying (what the buyer needs to make the sale), Using (what the user needs to solve their problem), Vision (long-term strategic goals), Competitive (stay competitive). Apply as per-criterion multipliers (example weights B=2, U=1, C=1, V=1).
Group & Group Order: a Group is two or more requirements that make sense to solve together; Group Order + Priority set the sequence handed to development. "Deliver 100% of something, not 70% of everything."
Interview the user (batch questions)
- The target release goal and what market forces / content is driving it.
- The personas involved (link or summarize).
- The list of problems (persona's first person) + the evidence count for each.
- Impact rating per problem (use the scale) and any contractual must-haves (99999).
- Which problems naturally group together.
Artifact template — Market Requirements Document (MRD)
# <Product Name> — Market Requirements Document
*This document is confidential and subject to change. For internal use only. No external
commitments can be made based on this document since it is in early planning stages.
Content and timing are very likely to change.*
**Company:** <company> · **Feature / Product:** <product name>
**Author:** <author> · **Contact:** <email> · **Date created:** <date> · **Date last updated:** <date>
## Overview of Target Release
<What is the goal for this release? What market forces are driving this project? What
other artifacts have been created? Are we driven primarily by content or by a target date?>
## Requirements
### GROUP #1 — <Group Name>
<Short description of the group.>
**Requirement #1 — <problem>**
<Persona> has <problem, described in a use scenario> with <frequency>.
**Priority:** 25 (inputs) × 4 (impact) = 100
**Requirement #2 — <problem>**
<Persona> has <problem> with <frequency>.
**Priority:** <evidence> × <impact> = <priority>
### GROUP #2 — <Group Name>
…
## Persona Details
<Full personas, one per page or linked.>
## Requirements Summary
| Name | Market Evidence | Impact | Priority (Evidence × Impact) | Group Name | Group Order |
| :--- | ---: | ---: | ---: | :--- | ---: |
| <req> | 25 | 4 | 100 | <group> | 1 |
<!-- Sort by Group Order ascending, then Priority descending. -->
## Approvals
| Name | Title | Date | Signature |
| :--- | :--- | :--- | :--- |
| | Systems Architect | | |
| | Interaction Designer | | |
| | Product Manager | | |
| | Development Manager | | |
| | Quality Assurance Lead | | |
| | Project Manager | | |
## Change Tracking
| Version | Date | Changes | Reason |
| :--- | :--- | :--- | :--- |
| 1.0 | <date> | Initial draft | — |
Deliver the artifact
Follow ../pm-copilot/references/artifact-output.md: confirm inputs, ask Markdown
or .docx, write the .md, convert to .docx on request via your environment's native document-creation capability. Then offer the next stages: add context with pm-use-scenarios,
assemble a full pm-prd, or commit an increment with pm-release-plan.
FAQ
What does the pm-requirements skill do?
Write market-driven, prioritized product requirements (a Market Requirements Document / MRD) the Pragmatic Institute way. Use when the PM asks for "requirements", "an MRD", "what should we build", "prioritize features", "market requirements", or wants development to stop saying "requirements aren't specific enough". Articulates each requirement as a persona's problem, prioritizes with Market Evidence × Impact, and groups them for delivery. Produces a Market Requirements Document as a Markdown or Word .docx artifact.
How do I install pm-requirements?
Run npx skills add https://github.com/julianoczkowski/product-manager --skill pm-requirements in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pm-requirements/ (personal) or .claude/skills/pm-requirements/ (project).
Which AI agents can use pm-requirements?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is pm-requirements safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains pm-requirements?
It is published by julianoczkowski in julianoczkowski/product-manager. It has 40 recorded installs.
More from julianoczkowski/product-manager
pm-copilot
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
pm-market-problems
julianoczkowski/product-manager
Run Pragmatic Institute market discovery and validate real market problems before anything gets built. Use when a PM says "I want to build a feature", "do market research", "talk to customers", "discovery", "validate this idea", "is this problem real", "NIHITO", or "who should I interview". Enforces the outside-in rule: build only for problems that are urgent, pervasive, and that the market will pay to solve. Produces a Market Discovery Document and a Market Problems Table as a Markdown or Word .docx artifact.
pm-opportunity-scoring
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
pm-product-strategy
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
pm-positioning
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
pm-gap-analysis
julianoczkowski/product-manager
Open the skill to read its SKILL.md instructions.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.