MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads pm-requirements automatically when relevant.

  3. 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:
ImpactDefinition
99999Contractual obligation
5Minimum purchase criteria (evaluator)
4Potentials lose time or money due to the problem
3Difficult for customers to achieve a primary goal
2Customers have difficulty with a non-primary goal
1Not 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)

  1. The target release goal and what market forces / content is driving it.
  2. The personas involved (link or summarize).
  3. The list of problems (persona's first person) + the evidence count for each.
  4. Impact rating per problem (use the scale) and any contractual must-haves (99999).
  5. 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

View all →

pm-copilot

julianoczkowski/product-manager

Open the skill to read its SKILL.md instructions.

41 installs

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.

Docs & Writing41 installs

pm-opportunity-scoring

julianoczkowski/product-manager

Open the skill to read its SKILL.md instructions.

41 installs

pm-product-strategy

julianoczkowski/product-manager

Open the skill to read its SKILL.md instructions.

40 installs

pm-positioning

julianoczkowski/product-manager

Open the skill to read its SKILL.md instructions.

40 installs

pm-gap-analysis

julianoczkowski/product-manager

Open the skill to read its SKILL.md instructions.

40 installs

Popular docs & writing skills

View category →

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.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs