gds-prd

Create, update, and validate game project PRDs through facilitated discovery and structured templates.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill gds-prd-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-prd
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/gds-prd
Command: npx skills add https://github.com/watchthelight/shatterfish --skill gds-prd-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Turning a game idea or existing GDD into a rigorous Product Requirements Document is hard: requirements drift into implementation detail, scope silently expands, and assumptions go unrecorded. This Skill facilitates the authoring of a PRD with stable FR/UJ IDs, explicit non-goals, tagged assumptions, and a decision log, so downstream UX, architecture, and story workflows have a reliable source. ## Core Features & Use Cases - Three intent modes: Create a new PRD through guided discovery, Update an existing PRD against a change signal with conflict surfacing, or Validate a PRD against a structured checklist with a rendered HTML/Markdown report. - GDD-aware brownfield path: When a Game Design Document exists, a subagent extracts its sections and pre-populates the PRD, flagging gaps the GDD does not cover. - Discipline enforcement: Capabilities-not-implementation FRs, glossary integrity, assumptions index, counter-metrics, and explicit non-goals, validated by a checklist-driven subagent. - Use Case: A solo developer with a finished GDD asks for a PRD to feed an external planning tool; the skill extracts the GDD, drafts a right-sized PRD with FRs and user journeys, logs every decision, and produces a validation report before handoff. ## Quick Start Ask the assistant to create a PRD for your game project based on your existing GDD, and it will begin a facilitated discovery session.

Frequently Asked Questions about gds-prd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a PRD from an existing game design document?

Invoke the skill with your GDD present and choose the From GDD path during discovery. A subagent extracts the GDD's sections, maps them onto the PRD structure, pre-populates the draft, and flags gaps the GDD does not cover.

What is the difference between a PRD and a GDD for game projects?

The GDD owns game design: mechanics, levels, art, audio, and progression. The PRD holds formal functional and non-functional requirements, player journeys with acceptance criteria, success metrics, and scope boundaries, referencing GDD decisions rather than relitigating them.

How do I validate an existing PRD against a checklist?

Use validate or review language when invoking the skill. It spawns a validator subagent that runs the configurable checklist against prd.md, writes structured findings, and renders an HTML report plus a Markdown twin grouped by severity.

Can the PRD workflow run headless without user interaction?

Yes. In headless mode the skill completes the detected intent without prompting, using provided inputs and workspace contents, and ends with a JSON status payload listing artifacts, assumptions, and open questions. Ambiguous intent returns a blocked status with a reason.

When should I use a GDD or quick-dev workflow instead of a PRD?

Use the GDD skill when capturing mechanics, levels, art direction, or progression, and the quick-dev path when you want to build immediately with no planning artifact. The skill surfaces these alternatives during its right-skill check and lets you choose.