tolulawson/ralph-prd
skills/ralph-prd/SKILL.md
Generate or update a Ralph-style project PRD in the current repository by asking a small number of high-value clarifying questions, then writing a structured PRD with epochs, bounded user stories, and verifiable acceptance criteria.
$ install --global
skillsauthnpx skillsauth add tolulawson/ralph-harness ralph-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 16, 2026, 11:28 AM5.9s3 files scanned
SKILL.md
- name:
- ralph-prd
- description:
- Generate or update a Ralph-style project PRD in the current repository by asking a small number of high-value clarifying questions, then writing a structured PRD with epochs, bounded user stories, and verifiable acceptance criteria.
Ralph PRD
Generate or update a Ralph-style project PRD for the current repository without invoking the full execution loop.
Use this as the direct public entry point for shaping work before planning or execution.
This public entrypoint is a thin launcher. It should keep the invoking thread focused on Ralph doctrine and immediately hand PRD work to a dedicated prd subagent.
In this source repository, the installable scaffold lives under src/, and target runtime records are created after installation rather than copied from repo-root source materials.
Use When
- The user wants a PRD without running the full harness.
- A new project or major initiative needs to be shaped into a durable artifact.
- The installed harness exists and the next useful step is product definition.
Workflow
- Read the current project context, existing PRDs, and any active notes relevant to the requested work.
- Immediately spawn a dedicated
prdsubagent with forked context semantics and the canonical Ralph PRD config. - Keep the invoking thread thin after launch. It may pass the repo path or user request into the
prdsubagent, wait for completion, and relay the result, but it must not generate the PRD inline or fall back to current-session PRD authoring. - Inside the
prdsubagent, ask3-5high-value clarification questions if important ambiguity remains. - Prefer short, lettered answer options where that will help the user answer quickly.
- Write or update
tasks/prd-<project>.mdusing a consistent structure. - Include an initial epoch map that groups likely specs into ordered milestones.
- Keep user stories small enough to hand off cleanly into numbered specs and execution.
- Write verifiable acceptance criteria for each story or requirement.
- Do not implement code or create downstream execution artifacts in this skill.
- Recommend the next entry point:
$ralph-planwhen the spec queue should be generated next$ralph-executewhen the installed harness should continue from state
Outputs
tasks/prd-<project>.md- a concise recommendation for the next public entry point
References
- Read
references/prd-contract.mdfor the expected PRD structure and quality bar.
Completion
Stop once the PRD is written or updated and the next recommended entry point is clear.
Related Skills
tolulawson/deslopify-lite
development
VerifiedTrustedCommunity
Lightweight pre-review quality gate that removes common slop from changed code before handoff. Focuses on type strictness, single-responsibility boundaries, fail-fast error handling, DRY cleanup, and dead-code/workaround removal.
1SKILL.mdUpdated Apr 17, 2026
tolulawson/bootstrap
tools
VerifiedTrustedCommunity
Prepare the assigned spec worktree and local validation environment before any execution role begins.
1SKILL.mdUpdated Apr 16, 2026
tolulawson/analyze
testing
VerifiedTrustedCommunity
Perform a read-only cross-artifact consistency analysis across a numbered spec's spec, research, plan, and tasks files, surfacing duplication, ambiguity, coverage gaps, and inconsistencies before implementation continues.
1SKILL.mdUpdated Apr 16, 2026
tolulawson/ralph-upgrade
testing
VerifiedTrustedCommunity
Upgrade an already-installed Ralph multi-agent runtime in the current repository from the latest tagged scaffold surface while preserving project-owned runtime files and history.
1SKILL.mdUpdated Apr 16, 2026