write-a-prd SKILL.md skillA

write-a-prd from chrislacey89/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add chrislacey89/skills/write-a-prd@git:20261030.5d7f43e

Pins git:20261030.5d7f43e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
chrislacey89/skills
Path
write-a-prd/SKILL.md
Versions recorded
20
Latest version
git:20261030.5d7f43e, committed Oct 30, 2026
First version recorded
May 15, 2026
Size
38,259 bytes
Repository stars
4
License
MIT

Primary pipeline shaping step after /research and before /prd-to-issues. Use when the problem is understood well enough to turn into a bounded PRD issue. May invoke /design-an-interface or /api-design-review when interface or contract uncertainty remains. Not for discovery, decomposition, or implementation-ready work.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Write a PRD

This skill produces a shaped pitch — a PRD that's rough enough for builder judgment, solved enough to ship, and bounded by an explicit time appetite. Follow the steps below, adapting depth to the work but not skipping the checks that establish appetite, current code reality, institutional knowledge, and handoff readiness.

> **One question per turn.** Throughout this skill's interview, ask one question at a time and wait for the user's answer before asking the next. Never present multiple questions in a single message, even when they are short.
>
> **Prefer single-select.** Use single-select multiple choice when the user is choosing one direction, one priority, or one next step.
>
> **Use multi-select rarely.** Reserve it for compatible sets — goals, constraints, non-goals, success criteria — that can all coexist. If prioritization matters, follow up asking which selected item is primary.
>
> **Use the platform's question tool when available.** In Claude Code, use `AskUserQuestion`; in Codex, `request_user_input`; in Gemini, `ask_user`. Otherwise, present numbered options in chat and wait for the user's reply before proceeding.

## Invocation Position
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add chrislacey89/skills/write-a-prd@sha256:8d886ab9da2512d9

The line at the top of this page pins the label git:20261030.5d7f43e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_axntp63hwj3tw4qt.svg)](https://markdownregistry.com/a/art_axntp63hwj3tw4qt)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 20 versions of this file, between May 15, 2026 and Oct 30, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261030.5d7f43e latest2026-10-30 5d7f43e 38,259 BA view · diff
git:20261030.6cecfb32026-10-30 6cecfb3 38,220 BA view · diff
git:20261026.c1c11f22026-10-26 c1c11f2 37,803 BA view · diff
git:20261025.f7325aa2026-10-25 f7325aa 37,760 BA view · diff
git:20261020.f57e6a32026-10-20 f57e6a3 35,288 BA view · diff
git:20261020.fdb73042026-10-20 fdb7304 35,652 BA view · diff
git:20261020.50d83ac2026-10-20 50d83ac 35,752 BA view · diff
git:20261020.ef5d7a92026-10-20 ef5d7a9 35,683 BA view · diff
git:20261019.4e767b12026-10-19 4e767b1 35,706 BA view · diff
git:20261019.7550c8d2026-10-19 7550c8d 35,799 BA view · diff
git:20261018.de83efe2026-10-18 de83efe 34,966 BA view · diff
git:20261018.026d7602026-10-18 026d760 34,939 BA view · diff
git:20261018.0fb326b2026-10-18 0fb326b 34,920 BA view · diff
git:20261014.01ed2772026-10-14 01ed277 32,982 BA view · diff
git:20260914.f3fd7e62026-09-14 f3fd7e6 32,323 BA view · diff
git:20260901.76864402026-09-01 7686440 30,131 BA view · diff
git:20260713.39940342026-07-13 3994034 29,307 BA view · diff
git:20260526.e9a5c8e2026-05-26 e9a5c8e 28,554 BA view · diff
git:20260526.7886f1c2026-05-26 7886f1c 27,923 BA view · diff
git:20260515.2f3c7b12026-05-15 2f3c7b1 27,407 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (38259 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

chrislacey89/skills · 4 stars · license MIT · pushed 2026-11-06 · branch prod

API

GET https://markdownregistry.com/api/v1/artifacts/art_axntp63hwj3tw4qt
GET https://markdownregistry.com/api/v1/resolve?ref=chrislacey89/skills/write-a-prd
GET https://markdownregistry.com/api/v1/blob/8d886ab9da2512d940b84531f1fb5ff3e40ba4229eefb385b63938dba4c5b7ea

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from chrislacey89/skills

CLAUDE.md CLAUDE.md file
chrislacey89/skills · CLAUDE.md
git:20261106.e899164 · audit A · 4 stars
api-design-review SKILL.md skill
chrislacey89/skills · api-design-review/SKILL.md · Invoked helper skill for higher-risk API contract decisions, usually called from /research or /write-a-prd. Use when…
git:20260407.d6d717b · audit A · 4 stars
closeout SKILL.md skill
chrislacey89/skills · closeout/SKILL.md · Primary pipeline tail step after /pre-merge, when a reviewed PR is ready to land and you want the workspace back to a…
git:20261105.863eae4 · audit A · 4 stars
compound SKILL.md skill
chrislacey89/skills · compound/SKILL.md · Primary pipeline knowledge-capture step that closes the compounding loop. Capture a durable lesson in docs/solutions/…
git:20261105.863eae4 · audit A · 4 stars
correct-course SKILL.md skill
chrislacey89/skills · correct-course/SKILL.md · Side-route skill for explicit backtracking when an upstream artifact becomes untrustworthy. Use when research, PRD, or…
git:20261029.1549c2c · audit A · 4 stars
create-milestone SKILL.md skill
chrislacey89/skills · create-milestone/SKILL.md · Primary planning branch after /shape for major-tranche work that requires multiple independent PRDs. Use to create a…
git:20261021.d548445 · audit A · 4 stars
design-an-interface SKILL.md skill
chrislacey89/skills · design-an-interface/SKILL.md · Invoked helper skill for unresolved module boundaries, usually called from /write-a-prd. Use to compare multiple…
git:20260408.27121d1 · audit A · 4 stars
excavate SKILL.md skill
chrislacey89/skills · excavate/SKILL.md · User-invoked side-route for onboarding to a legacy repo with no docs/solutions/, research archive, or written…
git:20261105.01fdd6e · audit A · 4 stars
execute SKILL.md skill
chrislacey89/skills · execute/SKILL.md · Primary pipeline execution step after /prd-to-issues or for clearly scoped implementation work. Use to build, verify…
git:20261106.4cf0576 · audit B · 4 stars
fix-findings SKILL.md skill
chrislacey89/skills · fix-findings/SKILL.md · Invoked helper skill for fixing the review findings a human has already chosen (from a /pre-merge review, or teammate…
git:20261105.c15b677 · audit A · 4 stars
git-guardrails-claude-code SKILL.md skill
chrislacey89/skills · git-guardrails-claude-code/SKILL.md · Infrastructure safety skill for blocking dangerous git commands in Claude-driven workflows. Use when the repo or user…
git:20261025.18d51e4 · audit A · 4 stars
hackathon SKILL.md skill
chrislacey89/skills · hackathon/SKILL.md · User-invoked side-route for a judged, time-boxed hackathon day: turns the event brief into a scored project choice, an…
git:20261106.e899164 · audit A · 4 stars

Every file in chrislacey89/skills

Browse by kind, by grade A, or by owner.