Skip to content

anatasof/NatPRD

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PRD Maker

A friendly assistant for Claude that interviews you and writes a professional Product Requirements Document (PRD) — the plan behind a product or feature — without ever making up facts.

You talk, it asks smart questions, and a complete, well-structured document comes out the other end. No template wrangling, no blank-page paralysis, and — importantly — no invented numbers, names, or evidence.


Contents


What is this, in plain words?

A PRD (Product Requirements Document) is the single document a team agrees on before building something. It answers: What are we building? Who is it for? Why now? How will we know it worked? What's in scope, and what isn't?

Writing a good one is hard. It's easy to leave gaps, to describe a solution before you've explained the problem, or — when you're in a hurry — to write down a number you think is right but never actually measured.

PRD Maker is a "skill" (an add-on) for Claude that fixes this. It:

  1. Interviews you one question at a time, in plain language.
  2. Writes the document for you as you answer, following a proven structure.
  3. Refuses to invent things. If you don't know a number, it writes a clearly-marked "to be determined" placeholder instead of guessing.
  4. Checks its own work and gives the finished document a score out of 100, with a list of anything still missing.

You end up with a document that looks like it came from an experienced product manager — because the rules of an experienced product manager are baked in.


Who is it for?

  • Product managers who want a faster path to a rigorous PRD.
  • Founders and solo builders who've never written a PRD and want guardrails.
  • Engineers, designers, and analysts asked to "write up" a feature.
  • Anyone in a regulated industry (finance, health, anything touching personal data) who needs the compliance angle handled carefully.

You do not need to be technical. If you can have a conversation, you can use this.


Why people use it

What you might struggle with How PRD Maker helps
Staring at a blank page It asks you questions instead — you just answer
Forgetting important sections It walks through every required section in order
Vague requirements It turns each one into a clear "user story" with testable conditions
Made-up or fuzzy numbers It never fabricates — unknowns become visible [TBD] markers
"Is this good enough to share?" It scores the document 0–100 and lists what's missing
Regulations you're unsure about It looks up likely rules, shows you the official source, and asks you to confirm
Claims with no backing Every sourced fact is quoted and linked, never paraphrased from memory

How it works

PRD Maker has three modes. You don't pick them — Claude figures out which one you want from how you ask.

Mode You say something like… What happens
Generate "I want a PRD for…" A short intake, then a guided section-by-section interview, then a finished document
Review "Review my PRD" It reads an existing document, scores it, and tells you what to fix
Update "Update the hypothesis" It edits just one section and re-checks it

In Generate mode there's a deliberate two-step rhythm:

  1. Intake first. Before writing anything, it asks a handful of orienting questions — what kind of product, which platforms, how many teams, whether any sensitive data is involved, how far along the idea is. This is so it never has to guess later.
  2. Then the interview. It works through each section in order, validates your answer, shows you the finished section, and moves on.

Two nice touches happen automatically: the document's version number ticks up as it changes (v0.1 → v0.2 → … → v1.0 when approved), and the "last updated" date is always kept current.


A quick example

Here's the flavor of a Generate session (shortened):

You:  I want a PRD for letting customers pay with a QR code.

PRD Maker:  Great — a few quick questions before we start the document.
            1. What's a working name for this?
            2. In one sentence: what is it trying to do, and for whom?

You:  "QR Pay." It lets shoppers pay merchants by scanning a code.

PRD Maker:  You mentioned payments, so some financial regulations probably
            apply. Based on your market (Indonesia), these likely matter:
            PCI-DSS, Bank Indonesia's SNAP open-payment standard, and the
            personal-data law UU PDP. This is a starting point, not legal
            advice — does that look right, or should I add/remove any?

You:  That's right.

PRD Maker:  Noted. I'll carry those into Background, Scope, and Risks.
            Now — what problem are we solving, and who feels it today?
...

Notice what it did: it gathered context first, flagged the compliance angle, showed you its sources for you to confirm, and only then started writing.


Installation

What you need

  • Claude. Either Claude Code (an app that runs on your computer and can save files) or the Claude app (web/desktop/mobile).
  • That's it for most people. (The optional self-check helper scripts use Python 3, which already comes installed on Mac and Linux. You don't need to touch them yourself.)

Option 1 — Claude Code (recommended; it can save files for you)

If you're comfortable with a terminal:

git clone https://github.com/anatasof/NatPRD.git ~/.claude/skills/natprd

Restart Claude Code and the skill loads automatically.

If you'd rather not use a terminal:

  1. Go to github.com/anatasof/NatPRD.
  2. Click the green Code button → Download ZIP.
  3. Unzip it, and rename the folder to natprd (all lowercase).
  4. Move that folder into your Claude skills folder:
    • Mac: open Finder, press ⌘ Shift G, paste ~/.claude/skills, press Enter, and drop the folder in.
    • Windows: go to C:\Users\[your name]\.claude\skills\ and drop the folder in.
  5. Restart Claude Code.

Now just say what you need — Claude handles the rest.

Upgrading from an old install? If you previously had it at ~/.claude/skills/NatPRD/ (capital letters), rename it to lowercase natprd. On Mac/Linux: mv ~/.claude/skills/NatPRD ~/.claude/skills/natprd.

Option 2 — Claude app (web, desktop, mobile)

The Claude app can't install skills directly, so you load the instructions manually — a one-time copy-paste:

  • Best for repeated use: create a Project in the Claude app → Edit project instructions → paste in the entire contents of the SKILL.md file from this repo → Save. Every chat in that project now follows the PRD workflow.
  • Quick alternative: click your profile → Customize Claude → paste SKILL.md into the instructions box → Save.

One difference: the Claude app can't save files to your computer. It will write the full PRD in the chat, and you copy it out and save it yourself as docs/prd.md.


How to use it

Once installed, just talk to Claude naturally:

Create a new PRD
  "I want a PRD for adding two-factor authentication"
  "Help me write a PRD for the merchant onboarding flow"
  "Create a PRD for our loyalty points system"

Review an existing PRD
  "Review my PRD"
  "Validate the PRD at docs/prd.md"

Change one part
  "Update the hypothesis in the PRD"
  "Add a new user story to the requirements section"

Make a short version for stakeholders
  "Generate a one-page summary of the PRD"

What's inside a PRD

Every PRD has 12 core sections (always included) and up to 4 optional sections (added only when they're relevant — for example, the Risks section appears automatically when sensitive data is involved).

Core sections (always)

# Section In plain words
1 Initiative Name A short, clear name for the thing you're building
2 Document Status Who wrote it, who owns it, who reviews/approves it, and which version this is
3 Background The problem, who it hurts, and proof it's real — plus any regulations and benchmarks
4 Objective The single business outcome you want, with measurable targets
5 Scope & Boundaries What's included, what's deliberately left out, and why
6 Hypothesis Your bet, written so it can be proven right or wrong
7 Success Metrics The numbers that tell you it worked (and the ones that must not get worse)
8 Requirements Each need written as a "user story" with testable pass/fail conditions
9 Solution How it works for the user, with links to designs and the alternatives you rejected
10 Metric Monitoring Who watches the dashboards after launch, and when to pull the plug
11 Event & Data Tracking Exactly what gets measured, so the metrics in §7 actually have data
12 FAQ Questions people have asked, with answers and owners for the open ones

Optional sections (only when relevant)

# Section Added when…
13 Risks & Mitigations Payments, regulated data, or multiple teams are involved
14 Dependencies You rely on another team or an outside vendor
15 Launch Plan The rollout is staged, phased, or needs sign-offs
16 Stakeholder Map Several teams or external parties need to be kept in the loop

Smart research features

PRD Maker can pull in real, verifiable facts — but only from sources you point it to or from a small built-in list of official references. It never goes searching the web on its own, because that's how AI tools end up citing things that don't exist.

1. Regulation look-up

When your idea touches money, identity, health, or personal data, the skill consults a built-in, dated list of regulations (references/regulations.json) and suggests the ones likely to apply — each with a link to the official source. It covers common rules across regions, including:

GDPR, PCI-DSS, HIPAA, PSD2, CCPA/CPRA, Singapore's PDPA & MAS Notice 626, Thailand's PDPA, Indonesia's UU PDP & OJK rules & Bank Indonesia SNAP, China's PIPL, Illinois BIPA, COPPA, India's RBI rules, and the FATF anti-money-laundering standards.

It then asks you to confirm the list (it's a starting point, not legal advice), and can optionally fetch the official page to quote the exact obligation. If you're unsure, it writes [TBD — legal/compliance to confirm] rather than inventing requirements.

2. Benchmarks

If you want to ground a target in an industry or competitor number ("top apps in our space convert at X%"), it records it with the source, the date, and a comparability note (because a benchmark from a different market or definition can mislead). It will never invent a benchmark figure.

3. Reading API / vendor docs

If your feature relies on an outside service (a payment processor, an identity checker, a cloud vendor), the skill can read that vendor's official documentation and pull real limits — rate limits, quotas, uptime promises — straight into the relevant sections. If the docs don't say, it writes [TBD — confirm with vendor docs].

4. Citations

Every fact that comes from a source is quoted directly (never paraphrased from memory) and tagged inline like [source: …, retrieved: 2026-06-03]. All sources are also collected into a single References / Sources list at the bottom, so a reviewer can audit where every claim came from.


The honesty guarantee

This is the feature people care about most, so it's worth stating plainly:

PRD Maker will not make things up.

If you don't have a number, a name, a date, a design link, or evidence, it writes a visible placeholder — like [TBD — baseline needed] or [No design link — status: Draft] — instead of inventing something plausible. Those placeholders are deliberately ugly so they're easy to spot and fix, and they pull the document's score down until they're resolved.

It also pushes back gently when you're vague, and it never paraphrases a source — it quotes the exact words or number. The result is a document you can trust: anything stated as fact is either something you confirmed or something clearly marked as still-open.


Quality score

When the document is done (or when you ask it to review one), PRD Maker scores it out of 100 and tells you the band:

Score Band What it means
90–100 Excellent Ready to circulate for review
75–89 Good Solid — fix the flagged warnings first
60–74 Needs Work Several sections are incomplete
Below 60 Not Ready Major gaps — don't share yet

The report separates hard problems (violations — things that must be fixed) from softer ones (warnings — things you should look at), and lists exactly where each one is.


Where your files go

  • Your PRD: docs/prd.md (or any path you ask for, e.g. "save it to prds/2026-q3-auth.md").
  • The quality report: shown right in the chat after it's written.
  • Optional one-page summary: docs/prd-summary.md, for stakeholders who won't read the full thing.

(In the Claude app, which can't save files, all of this appears in the chat for you to copy.)


Does it use the internet?

Yes — because Claude does. The skill is just a set of instructions that Claude follows, and Claude runs by talking to Anthropic's servers over the internet (in both Claude Code and the Claude app). So this isn't an offline tool: you need a connection for it to work at all, and your conversation — including any files or text you share — is sent to Claude exactly like in a normal chat.

What the skill itself won't do is wander off and browse the web on its own. That part is deliberately locked down:

  • It only opens a web page you named (or an official source it suggested and you confirmed), and it shows you every fetched fact before using it.
  • It never runs open-ended web searches. If you didn't name a source, the skill treats it as not existing and writes a [TBD] instead.
  • Reading files on your computer and the built-in reference lists pulls nothing extra from the web — though, like everything in the chat, their contents are still processed by Claude.
  • Private/locked pages (Confluence, Jira, internal wikis) can't be fetched — it'll ask you to paste the relevant text instead.

You can switch the skill's own web access off entirely by removing the WebFetch capability from the top of SKILL.md; it still works, it just asks you to paste anything it would otherwise fetch. (That only stops the skill from fetching pages — it doesn't make Claude itself run offline.)


For the technically curious

Everything below is optional — the skill works without you ever opening these files.

File structure

natprd/
├── SKILL.md                      ← The skill's brain — instructions Claude reads
├── README.md                     ← This file
├── templates/
│   ├── prd-template.md           ← The blank PRD structure
│   └── prd-summary-template.md   ← The one-page summary structure
├── prompts/
│   ├── interview-questions.md    ← The questions asked for each section
│   ├── section-rules.md          ← The pass/fail rules for each section
│   └── validation-rules.md       ← How the 0–100 score is calculated
├── references/
│   ├── regulations.json          ← The dated regulation list (rules → official URLs)
│   └── api-docs.md               ← Official documentation links for common vendors
└── scripts/
    ├── validate.py               ← Scores a PRD automatically (Python 3, no extra installs)
    └── lookup_regulation.py      ← Suggests regulations from the list (Python 3, no extra installs)

Run the checks yourself

Score any PRD file (prints a detailed JSON report — per-section scores, violations, warnings):

python3 scripts/validate.py docs/prd.md

See which regulations the built-in list suggests for a given situation:

# signals: payments, ekyc, pii, credit, insurance, biometric, healthcare, cross_border, children
# geo: a country code such as ID, SG, EU, US, US-CA
python3 scripts/lookup_regulation.py --signals payments,pii --geo ID

Both scripts use only Python's standard library — nothing to install. The automated score is the structural baseline; Claude layers human-judgment checks (is the problem really stated before the solution? is the owner a real person, not a team?) on top.

How the score is split

The validator checks structure deterministically (valid status, named reviewers, two test scenarios per requirement, events that map to metrics, monitoring fields filled in, open FAQ items having owners, regulation rows naming a specific regulation, citations carrying a date, and so on). Anything that needs judgment is left to Claude. The total is always out of 100; optional sections are checked but don't change the number.


Customize it for your team

PRD Maker ships with sensible, opinionated defaults — but every team has its own house style, its own definition of "done," and its own regulations. The skill is built to be molded to your workflow. The cleanest way to do that is to fork it: make your own copy that you fully control, change whatever you like, and still pull in future improvements from the original.

Everything that drives the skill is a plain text file — no programming required for most changes. If you can edit a document, you can customize the skill.

Step 1 — Fork the repo (make your own copy)

A "fork" is your personal copy of this project on GitHub. You own it, you can change anything in it, and it stays linked to the original so you can pull updates later.

  1. Go to github.com/anatasof/NatPRD and click Fork (top-right). You now have your own github.com/your-username/NatPRD.
  2. Install your fork instead of the original — the same steps as Installation, just with your URL:
    git clone https://github.com/your-username/NatPRD.git ~/.claude/skills/natprd
    No terminal? Download your fork's ZIP and drop it into ~/.claude/skills/ exactly as in the install steps.
  3. Edit the files, save, and restart Claude Code. Changes take effect right away.

Just trying things out? You can also edit the installed files in ~/.claude/skills/natprd/ directly, without forking. Forking is the better long-term choice if you want to keep your changes safe, share them with teammates, or pull in future updates.

Step 2 — Change what you need

Here's everything you can tailor, and — just as importantly — what you gain by doing it:

File What it controls A change you might make What you gain
templates/prd-template.md The shape of the final document — sections, headings, tables Add a "Localization" section, add your company header, or drop a section you never use Output matches your house style — no reformatting after the fact
templates/prd-summary-template.md The one-page stakeholder summary Add the three numbers your execs always ask for Leadership gets exactly what they scan for
prompts/interview-questions.md The questions Claude asks for each section Add probes your team always forgets (accessibility, fraud, data retention) Those gaps stop slipping through — they're captured every time
prompts/section-rules.md The pass/fail rules per section Tighten or relax a standard; require a field you care about The skill enforces your definition of "done"
prompts/validation-rules.md How the 0–100 score is weighted Make Requirements worth more; add a rule for a section you added The score reflects your priorities, not the defaults
references/regulations.json The built-in regulation list Add your country's rules, fix a source URL, update last_reviewed Compliance suggestions fit your market and stay current
references/api-docs.md Official documentation links for vendors Add the payment / identity / cloud vendors you actually use Real API limits get pulled from your real stack
scripts/validate.py The automated structural checker Add a check for a mistake your team keeps making Recurring errors get caught automatically, before human review
SKILL.md The skill's overall behavior and trigger phrases Change the default save path, the tone, or how it's activated The workflow fits how your team already talks and works

Customization recipes (by workflow)

  • "We're a fintech in Indonesia." Confirm or add OJK / Bank Indonesia entries in regulations.json, default to --geo ID, and add payments-specific probes (duplicate-charge, settlement timing) to interview-questions.md. → The compliance and edge cases you care about are handled by default.
  • "We don't use Gherkin." Replace the Given/When/Then block in prd-template.md, update the §8 rules in section-rules.md, and adjust the scenario check in validate.py. → Requirements come out in your preferred format.
  • "Our execs only read summaries." Expand prd-summary-template.md with your KPIs and a one-line risk callout. → One-pagers land without extra editing.
  • "We always forget accessibility." Add an accessibility question to §8 and a matching rule. → Every PRD now covers it.
  • "We live in Jira / Linear." Add ticket-link fields to the template and a question that prompts for them. → Traceability to your tracker is built in.

Keep the four "scoring" files in sync

If you add, rename, or remove a section, update these four together so the score stays correct — they form a chain:

templates/prd-template.md (defines the section) → prompts/section-rules.md (defines pass/fail) → prompts/validation-rules.md (sets the points) → scripts/validate.py (does the automatic check)

After any change, run a quick self-test to make sure the checker still works:

python3 scripts/validate.py docs/prd.md

Pull in future updates (optional)

Because you forked, you can keep your copy fresh without losing your edits:

git remote add upstream https://github.com/anatasof/NatPRD.git   # one time only
git fetch upstream
git merge upstream/main      # bring in new features; resolve any overlap with your changes

And if you build something broadly useful, consider opening a pull request back to the original — other teams benefit, and your change rides along with future releases.


Glossary

New to product-doc jargon? Here's what the terms mean.

Term Plain meaning
PRD Product Requirements Document — the plan for what you're building and why
User story A requirement written as "As a [type of user], I want to [do something], so that [benefit]"
Gherkin / acceptance criteria A simple "Given / When / Then" recipe describing exactly what counts as the feature working
NFR Non-Functional Requirement — qualities like speed, security, or uptime (not a feature itself)
Leading vs. lagging metric Leading moves early and predicts success; lagging confirms it later
Guardrail metric A number that must not get worse as a side effect of your change
MoSCoW Priority labels: Must-have / Should-have / Could-have / Won't-have-this-time
Baseline / target Where a metric is today vs. where you want it to be
Hypothesis Your testable bet about what will happen and why
Scope What's included; out of scope is what you're deliberately leaving out
PII Personally Identifiable Information — data that can identify a person
eKYC Electronic "Know Your Customer" — verifying someone's identity online
DRI Directly Responsible Individual — the one named person on the hook
[TBD] "To be determined" — a visible placeholder for something not yet known

FAQ

Do I need to be technical to use this? No. You answer plain questions in a chat. The technical files run behind the scenes (and only in Claude Code).

Does it work in the regular Claude app, not just Claude Code? Yes — paste SKILL.md into a Project's instructions or into "Customize Claude." The only difference is the app can't save files for you, so you copy the finished PRD out of the chat.

Why does it ask so many questions before it starts writing? So it never has to guess. A few minutes of context up front is what lets it avoid invented metrics, fake design links, and made-up evidence later.

Will it ever invent a number or a name to fill a gap? No. That's the core promise. Gaps become visible [TBD] markers that lower the score until you fill them.

Can I change the template or rules to match my company's standards? Yes — that's encouraged. See Customize it for your team for the full list of what you can change (and the upside of each), starting from forking the repo.

Is the regulation list legal advice? No. It's a helpful, dated starting point that always asks you to confirm and points to official sources. Treat it as a prompt to check with legal/compliance, not a substitute for them.

Is my data sent anywhere? Your conversation is processed by Claude over the internet, just like any other Claude chat — that's how Claude works at all. Beyond that, the skill fetches only the pages you explicitly name (or confirm), shows you every fetched fact before using it, and never runs background web searches. See Does it use the internet?.


License

BSD 3-Clause — free to use and redistribute, with attribution. Don't use the author's name to endorse derived works.

About

A friendly assistant for Claude that interviews you and writes a professional Product Requirements Document (PRD) — the plan behind a product or feature — without ever making up facts.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages