prd-review
Skill17 starsChanged 58 days agoMITView on GitHub
Full PRD review in one pass through two lenses — engineering (feasibility, metrics, gaps, decision quality, dependencies, learning plan) and product/PM (right problem, right audience, solution quality, hypothesis strength, documentation completeness). Use before committing engineering effort to a PRD.
16 other projects use a version of this.
Adopted by
Most recently taken up by
- jikefan/product-manager-skillstheir own version, first seen Nov 8, 2026
- ritamgh/claude-skillstheir own version, first seen Nov 1, 2026
- The-AI-Thinker/claude-code-pm-startertheir own version, first seen Oct 15, 2026
- wuyining0130/c-roomtheir own version, first seen Oct 15, 2026
- osac-project/osac-ai-skillstheir own version, first seen Oct 13, 2026
- sashabogi/trantortheir own version, first seen Oct 11, 2026
Used with
Projects with it also use design-review.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
dillonluiSkilldesign-review
Review a view or flow for UX and UI issues. Provides severity-ranked, actionable findings grounded in established design heuristics. Use when the user asks for design feedback, UX review, or UI critique.
Also in 3 projects that use this
Other versions16 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 16
- cenconq25/claude-code-app-studio★ 40same name
- TayaIntelligence/skills★ 32same name
- The-AI-Thinker/claude-code-pm-starter★ 13same name
- andrewthetechie/andrew-skills★ 6same name
- yihannangua/prd-review-skill★ 5same name
- jikefan/product-manager-skills★ 4same name
- shitiandou83-maker/claude-skills★ 2same name
- janellecipriano/pm-skills★ 1same name
- mikeweib/claude-skills★ 1same name
- sashabogi/trantor★ 1same name
6 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adr-challengerSkill
- api-designSkill
- architecture-decisionsSkill
- async-systemsSkill
- code-reviewSkill
- database-engineeringSkill
- dora-metricsSkill
- engineering-economicsSkill
- incident-responseSkill
- nestjs-architecture-guardianSkill
- node-runtime-reliabilitySkill
- observabilitySkill
- performance-analysisSkill
- production-readinessSkill
- release-planningSkill
- repo-onboardingSkill
- safe-refactoringSkill
- security-reviewSkill
- systematic-debuggingSkill
- test-strategySkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 11 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Ensure the team builds the right thing AND can build it well.
- Distinctive: line 60
Should this ship as an experiment or staged rollout, not all at once?
- Distinctive: line 89
No baseline metric. Vague "improve UX" goals.
“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Mission
Ensure the team builds the right thing AND can build it well. Review the PRD the way a staff engineer and a senior PM would in a peer review — critique and ask, never rewrite. The PRD belongs to the PM; this skill produces feedback.
When to use
- Reviewing a PRD before engineering commitment.
- The daily routine review of PRDs synced from Drive.
Handoff
- Receives from: principal-engineer (initial review).
- Hands off to: architecture-decisions (if approved) or back to the PM (if not).
Engineering lens
Front 1 - Problem, value & audience
- What metric proves this problem exists today? How big is it?
- Root cause or symptom?
- "Show me the number": baseline, expected gain, mechanism linking solution to gain.
- Cost-to-value ratio acceptable for the time horizon?
- Which users/personas are affected - and what happens to those who are NOT the target audience? What is the blast radius if it goes wrong?
Front 2 - Metrics & measurement
- Is the baseline credible and measured today?
- Are success criteria specific and measurable?
- Guardrail metrics - what must NOT regress?
- How and when is impact observed?
Front 3 - Gaps & hidden engineering work
- Sections missing or vague?
- Engineering work implied but unstated: migrations, backfill, infra, auth.
- Ambiguities that will block implementation.
- Quick feasibility check: does this conflict with ~/.claude/engineering/SYSTEM_INVARIANTS.md, or depend on a service/data that does not exist? (Deep design goes to /adr.)
Front 4 - Dependencies & sequencing
- Which other teams, systems, or PRDs does this depend on?
- What must exist before this can start?
- Coupling with work already in flight?
- Sequencing or ownership risk ("we found mid-build we needed team X")?
Front 5 - Decision quality & risk
- Is the scope disciplined, or a wishlist? Are cuts identified?
- Is the decision reversible if the bet is wrong?
- Operational cost (run + maintain) considered?
- Non-technical risk: legal/compliance, data privacy (LGPD), product-level security (does this expose sensitive data?), reputation. Cross-check ~/.claude/engineering/ENGINEERING_RISKS_FROM_PRD.md.
Front 6 - Learning plan
- Should this ship as an experiment or staged rollout, not all at once?
- What is the kill criterion - when do we decide it failed?
- How do we exit or roll back if the hypothesis does not hold?
- Measuring is not learning: is there an actual plan to validate the bet?
Product / PM lens
Front 7 - Product review (think like a senior PM)
- Right problem? Is this worth solving now, or a pet feature? Is it framed as a problem, or smuggled in as a pre-chosen solution?
- Right audience? Is the target user clearly defined and the real beneficiary?
- Solution quality? Were alternatives considered, or is this the first idea? Is the proposed solution the simplest one that solves the problem?
- Hypothesis strength? Is the "we believe X will cause Y" explicit and testable?
- User value clarity? Is the value to the user stated plainly, not just business value?
- Documentation completeness? Does the PRD contain what a PRD needs - context, user stories or scenarios, scope and out-of-scope, open questions, success criteria? Flag missing sections by name.
- Timeline & dates? Are there target dates or milestones? Are they justified or arbitrary? Is a deadline driving scope instead of the problem?
- Unanswered "why"s? List every decision stated without a reason ("we will do X" with no "because"). Those are the questions for the PM.
Red flags - reject
- No baseline metric. Vague "improve UX" goals. Scope with no cuts.
- Expected gain stated with no mechanism.
- Solution presented as the problem. No target user. No open-questions section.
- A date with no rationale, or a deadline silently driving the scope.
Output - PRD readiness report
Produce feedback for the PM; never rewrite their document.
# PRD READINESS - <title>
Verdict: APPROVE | ADJUST | REJECT
Readiness level: DRAFT | REVIEWABLE | ENGINEERING-READY (score 0-100)
## Completeness scorecard
Problem statement [ok / weak / missing]
Target audience [ok / weak / missing]
Evidence & baseline [ok / weak / missing]
Success metrics [ok / weak / missing]
Guardrail metrics [ok / weak / missing]
Scope & out-of-scope [ok / weak / missing]
Dependencies [ok / weak / missing]
Risks (legal/privacy) [ok / weak / missing]
Learning / kill plan [ok / weak / missing]
Timeline & milestones [ok / weak / missing]
Rollout & reversibility [ok / weak / missing]
## Product gaps (PM lens)
## Gaps & hidden engineering work (eng lens)
## Unanswered "why"s - questions for the PM
## Top issues blocking approvalDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

