raddue/prd
skills/prd/SKILL.md
Generate a stakeholder-facing PRD from a design doc. Use when you have a finalized design doc and need a non-technical product requirements document for archival or sharing. Triggers on /prd, 'generate PRD', 'write a PRD', 'product requirements'.
$ install --global
skillsauthnpx skillsauth add raddue/crucible prdInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 4:56 AM158.3s1 file scanned
SKILL.md
- name:
- prd
- description:
- Generate a stakeholder-facing PRD from a design doc. Use when you have a finalized design doc and need a non-technical product requirements document for archival or sharing. Triggers on /prd, 'generate PRD', 'write a PRD', 'product requirements'.
PRD Generator
Overview
<!-- CANONICAL: shared/dispatch-convention.md -->All subagent dispatches use disk-mediated dispatch. See shared/dispatch-convention.md for the full protocol.
Generates a Product Requirements Document (PRD) from a finalized design doc. The PRD reformats technical design decisions into stakeholder-friendly language — problem statement, user stories, requirements, scope, success metrics.
Announce at start: "I'm using the PRD skill to generate a product requirements document."
Core principle: The PRD derives everything from the design doc. It does not introduce new decisions or requirements — it translates existing technical decisions for a non-technical audience.
When to Use
- After
/designor/buildPhase 1 completes — you have a finalized design doc - When a stakeholder asks for a PRD, product spec, or requirements document
- When archiving a feature's requirements in Confluence, Jira, Notion, or similar
Input
The skill needs a design doc path. If not provided, it searches:
- Check if the user specified a path:
/prd docs/plans/2026-03-23-my-feature-design.md - If no path: scan
docs/plans/for the most recently modified*-design.mdfile - If no design docs found: inform user and stop
The Process
- Read the design doc — verify it exists and has the expected structure (Overview, acceptance criteria, etc.)
- Dispatch a Sonnet PRD Writer using the prompt template at
skills/build/prd-writer-prompt.md- Input: full design doc text
- Output: PRD in standard format
- Save to
docs/prds/YYYY-MM-DD-<topic>-prd.md - Commit:
docs: add PRD for [feature] - Report the file path to the user
PRD Structure
The generated PRD follows a fixed structure:
- Problem Statement — what problem this solves, in plain language
- User Stories / Use Cases — "As a [role], I want [goal] so that [benefit]"
- Requirements — functional and non-functional, each a testable statement
- Scope — what's included
- Out of Scope — what was explicitly excluded
- Success Metrics — measurable outcomes
- Technical Notes — brief architectural context for stakeholders who want it
- Dependencies — external systems, teams, or services
Integration
Called by:
- crucible:build — Phase 1 Step 2.5 (after design finalized, before acceptance tests). Runs by default in feature mode, skipped in refactor mode.
Standalone usage:
/prd <design-doc-path>— generate PRD from any design doc/prd(no args) — auto-detect most recent design doc
Prompt template: skills/build/prd-writer-prompt.md (shared with build pipeline)
Red Flags
- Inventing requirements not in the design doc
- Including code, file paths, or architecture diagrams in the PRD
- Writing more than 2 pages — PRDs should be concise
- Skipping sections rather than stating "Not specified in design"
Related Skills
raddue/delve
testing
VerifiedTrustedCommunity
Standalone instance-bug reviewer — runs a parallel finder fan-out + verify gate over a diff or a path and prints ranked, verified findings. Use when the user says "delve", "find bugs in this diff", "review this for bugs", "scan this file/subsystem for defects", "instance-bug sweep", or wants concrete reproducible defects (not a merge verdict, not systemic health). Works on a PR id, a base..head range, or a path, on any forge (GitHub, GitLab, Bitbucket, self-hosted).
10SKILL.mdUpdated Jun 4, 2026
raddue/ledger
testing
VerifiedTrustedCommunity
Render the Crucible calibration ledger weekly report — the honest "Crucible caught N silent bugs" headline, verdict breakdown, per-skill severity rates, and the inflation detector. Triggers on "/ledger", "weekly report", "weekly ledger", "caught N", "quality ledger", "calibration report", "render the ledger".
10SKILL.mdUpdated Jun 2, 2026
raddue/grudge
development
VerifiedTrustedCommunity
The Book of Grudges — cross-session bug graveyard. Every fixed bug is recorded as a structured "grudge"; before touching code, skills query the grudgebook for the files in scope and surface past regressions as forced "DO NOT REPEAT" context. Read mode (pre-flight) and write mode (on bug resolution / fix(*) PR). Machine-local, per-repo, never committed. Triggers on /grudge, "check grudges", "record a grudge", "any past bugs here", "regression oracle", "bug graveyard".
10SKILL.mdUpdated Jun 2, 2026
raddue/calibration-reconcile
testing
VerifiedTrustedCommunity
Reconcile the Crucible calibration ledger — walk merged fix/hotfix branches to falsify the originating gating-verdicts, compute per-skill Brier calibration scores, and append a falsification log. Triggers on "/calibration-reconcile", "reconcile ledger", "reconcile calibration", "falsify verdicts", "brier score", "calibration reconcile", "compute brier".
10SKILL.mdUpdated Jun 2, 2026