mrd-writing

mrd-writing is a skill for Claude Code, Codex from limengzhe27-boop/claude-product-doc-skills. It costs 198 tokens per session (4,255 once invoked), scanned A, original, MIT.

A guided tool for turning real user feedback into a market requirements document (MRD), which explains what a market needs before a product is designed.

In plain words
What is it for?
Use it to review comments or other user data, identify market needs, and create a structured MRD for later business and product planning.
Why use it?
It helps separate evidence from guesses and keeps unsupported conclusions out of the document.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code.

Good fit Use it to review comments or other user data, identify market needs, and create a structured MRD for later business and product planning.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add limengzhe27-boop/claude-product-doc-skills --skill mrd-writing
Clone the repo
git clone --depth 1 https://github.com/limengzhe27-boop/claude-product-doc-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mrd-writing

README.md
[![agentmods](https://agentmods.dev/badge/skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing/github.svg)](https://agentmods.dev/skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing)
Your own site
<a href="https://agentmods.dev/skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing"><img src="https://agentmods.dev/badge/skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mrd-writing

Your own site · 80×15
<a href="https://agentmods.dev/skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing"><img src="https://agentmods.dev/badge/skills/limengzhe27-boop/claude-product-doc-skills/mrd-writing.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 198 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,255 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00198 $0.04255
Opus 5 $0.00099 $0.02128
Sonnet 5 $0.00040 $0.00851
Haiku 4.5 $0.00020 $0.00426

Measured 12d ago against content hash d8e5f618a340, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

mrd-writing scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/mrd-writing/SKILL.md · 408 lines

How it starts

The opening of the file, as written. The whole thing — 408 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MRD Writer — 市场需求文档引导式生成器

你是一个靠谱的产品策略搭档,帮用户从真实用户数据中提炼市场信号,一步一步梳理出一份结构化的 MRD。

与其他 Skill 的衔接关系

/mrd → 从数据中分析市场需求 → MRD.md(本 Skill,第一步)
  ↓
/brd → 基于市场需求判断商业可行性 → BRD.md(读取 MRD.md)
  ↓
/prd → 定义具体产品方案 → PRD.md(读取 BRD.md)
  ↓
/design-spec → 设计规范 → DESIGN.md(读取 PRD.md)
  ↓
Claude Code → MVP 代码(读取 PRD.md + DESIGN.md)

链条质量原则:上游证据等级 🔴 → 下游最高只能 🟡。每一步都有「健康度闸门」拦住跑偏。


核心理念

  1. 所有结论必须基于真实数据,严禁捏造。 找不到数据支撑的结论不写——不是标警告,是直接不写。
  2. 完成比完美更重要。 3 个 Phase 搞定,不拖。
  3. 用选择题代替开放题。 每次给 2-3 个选项,降低思考负担。
  4. 从对话中判断用户水平,不要直接问。 从用户表述中感知认知水平,调整引导深度。
  5. 全程正向引导。 用户答不上来不是问题,是帮他发现盲区的信号。
  6. 产品形态默认 Web 端。 除非用户明确说要做 App,否则所有分析和建议都围绕 Web 产品(移动端优先的响应式网页)。

数据索引规则

MRD 的每一个结论都必须挂数据索引。索引格式根据数据情况自适应:

有评论 ID 或行号时:

  • [C-001, C-045, C-200] — 评论编号引用

按视频/帖子分组时:

  • [video_7522..., n=15] — 视频分组 + 支撑评论数量

通用规则:

  • 每个 P0/P1/P2 需求至少有 2 条以上原声支撑
  • 没有数据支撑的结论直接删除,宁可 MRD 更短
  • 禁止编造任何数字、比例、用户规模、增长率

用户层级判断(隐性,从对话中感知)

不要直接问用户水平,从信号判断:

  • 探索型(描述模糊、用"感觉""好像")→ 用最简单的选择题,每个概念给一句话解释
  • 实践型(有数据但不确定怎么解读)→ 引导从直觉走向结构化
  • 成熟型(有明确假设、能说清竞品)→ 跳过基础问题,重点查漏补缺

工作流程(3 个 Phase)

Phase 0:启动模式确认(30 秒)

进入数据分析前,告诉用户:

我可以两种模式跑:

A. 数据驱动(推荐):读你工作区里的数据文件,从真实评论中提炼市场需求 B. 假设驱动:你直接告诉我目标市场和你的猜测,我帮你写一份"待验证"的 MRD(不依赖数据,证据等级 🔴)

默认 A。如果手头没数据,选 B 也行——但 MRD 头部会标【🔴 探索性】。

确认后进入 Phase 1。


Phase 1:数据接入 + 质量评估

Step 1:检测数据文件

按以下顺序查找当前目录的文件:

  1. data-context.md — 数据说明文档(描述数据来源、字段说明、已知局限)
  2. *.json 文件 — 评论/反馈数据
  3. *.md 文件中包含评论/反馈内容的

Step 2:理解数据

  • 如果有 data-context.md先读它,理解数据的来源、字段结构、已知局限,再去分析数据文件
  • 如果没有 data-context.md:问用户 3 个快速问题(选择题):
    • 这批数据来自什么平台?(TikTok / 小红书 / Reddit / 其他)
    • 围绕什么关键词/话题采集的?
    • 目标地区/语言是什么?

Step 3:数据质量评估(必须输出)

扫描全部数据后,先输出一段数据评估,再继续后续分析:

📊 数据评估:
- 数据量:X 条原始记录(过滤无效内容后 Y 条可用)
- 来源:[平台 + 语言 + 内容主题]
- 能做的:[列出 2-3 项,如用户情绪分析、痛点聚类、场景提取]
- 不能做的:[列出 2-3 项,如精确市场规模、付费意愿量化、多国对比]
- 建议:[一句话说明数据的代表性边界]

Step 4:数据健康度闸门(必跑)

数据评估完成后,自检以下 4 项。只要有 2 项以上不满足,停下来给用户 3 条岔路

  • 有效数据(按 data-context.md 建议过滤短文本/无意义内容后) ≥ 500 条
  • 至少能聚出 3 个明确的痛点主题
  • 至少有 30 条带场景描述的评论(不是单纯表情/称呼)
  • 数据来源覆盖 ≥ 5 个不同视频/帖子(避免单源偏差)

Read the full file on GitHub · 408 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 408 lines · 198 tokens per session scan A d8e5f618a340

Subscribe to this mod's changes

mrd-writing is a skill published in the GitHub repository limengzhe27-boop/claude-product-doc-skills (2 stars, last pushed 1mo ago), licensed MIT. It adds 198 tokens to every session and 4,255 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

gtm-domain-library

Go-to-market domain knowledge for consumer marketplace, membership, subscription and AI-feature products: sharpening an ICP until it excludes someone, running a real user-interview panel, differentiating when the capability is rentable, launch-post anatomy, the value-metric pricing tree, the four-part deal test, and…

naderelewa/Product-to-Prod · 116 tokens

ai-shaped-readiness-advisor

Assess whether your product work is AI-first or AI-shaped. Use when evaluating AI maturity and choosing the next team capability to build.

deanpeters/Product-Manager-Skills · 33 tokens

agent-orchestration-advisor

Design multi-agent AI workflows with clear boundaries, handoffs, and monitoring. Use when a complex PM task should run as parallel specialized agents instead of one linear process.

deanpeters/Product-Manager-Skills · 40 tokens

company-intel

Research a company, industry, or competitor set using web search and seven analytical lenses. Use when you need structured intel that feeds downstream PM skills.

deanpeters/Product-Manager-Skills · 33 tokens

context-engineering-advisor

Diagnose context stuffing vs. context engineering. Use when an AI workflow feels bloated, brittle, or hard to steer reliably.

deanpeters/Product-Manager-Skills · 32 tokens

intelligence-collection-disciplines

Run competitive research like an intelligence agency: eight collection disciplines (OSINT to MASINT), signal-to-inference chains, and fusion. Use when one-source research isn't enough.

deanpeters/Product-Manager-Skills · 43 tokens