gds-gdd

Create, update, and validate Game Design Documents through guided discovery and genre-aware templates.

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill gds-gdd-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-gdd
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/gds-gdd
Command: npx skills add https://github.com/PastaSus/egg-defender --skill gds-gdd-pastasus

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Game teams often produce vague, pitch-deck-style design documents that fail downstream: mechanics without numbers, pillars that don't steer decisions, and genre conventions discovered as emergencies during production. This Skill coaches a designer through producing a dense, measurable, traceable Game Design Document that architecture, epic planning, and playtesting can actually build on. ## Core Features & Use Cases - Three intent modes: Create a new GDD through facilitated discovery, Update an existing GDD against a change signal with conflict detection, or Validate a GDD against a structured checklist with a rendered HTML/Markdown report. - Genre-aware scaffolding: Matches the game pitch against a game-type taxonomy (RPG, roguelike, fighting, MOBA, platformer, and more) and injects the matched genre guide's required subsections into the GDD template. - Traceability discipline: Enforces the chain Vision → Pillars → Core Loop → Mechanics → Epics, pushes every mechanic to concrete numbers, and keeps engine-implementation details out of the design document. - Use Case: A solo developer with a roguelike idea runs the skill, confirms the matched game type, walks pillars and run structure section by section, and receives gdd.md, epics.md, and a decision log ready for the architecture phase. ## Quick Start Ask the assistant to help you create a Game Design Document for your game idea and answer its discovery questions about pillars, core loop, and mechanics.

Frequently Asked Questions about gds-gdd

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

FAQPage Schema
How do I create a Game Design Document with AI assistance?

Invoke the skill with your game idea and it runs a discovery conversation covering pillars, core loop, mechanics, and scope before drafting. It writes gdd.md, epics.md, and a decision log to a workspace folder, appending sections as they are discussed.

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

In this workflow the GDD is the primary design document and canonical source of truth for game design intent, covering mechanics, levels, art, audio, and progression. A PRD is optional and exists only for formal functional requirements or external-tool compatibility.

How does the skill handle different game genres like RPG or roguelike?

It matches your pitch against a game-types CSV taxonomy, confirms the match with you, then loads a genre guide that scaffolds genre-specific sections such as RPG stat systems or roguelike seed determinism. A complexity CSV flags which genres carry mandatory conventions.

Can I validate an existing GDD instead of writing a new one?

Yes, the Validate intent runs a checklist covering quality, discipline, genre compliance, and structural integrity against your gdd.md and epics.md. Findings are rendered into HTML and Markdown reports with severity grades, and you can roll them into an update.

Does the GDD skill work in headless or non-interactive mode?

Yes, headless mode infers intent and game type from provided inputs without prompting, then ends with a JSON status block listing artifacts, assumptions, and open questions. If intent is ambiguous it halts with a blocked status and reason.

When should I not use a GDD for my game project?

If you only need formal functional requirements or PRD-format output for an external tool, a PRD workflow fits better. If you want to start building immediately with no design artifact, an express implementation workflow is the right choice.