gd-write-gdd

Generates structured Game Design Documents using a standardized template and player-centric framework.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill gd-write-gdd-unity-upm-packages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gd-write-gdd
Source: https://github.com/Unity-UPM-Packages/Antigravity-skills/tree/main/.agents/skills/gd-write-gdd
Command: npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill gd-write-gdd-unity-upm-packages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a Game Design Document from scratch is time-consuming and often produces inconsistent, incomplete specs that leave developers with unanswered questions. This Skill provides a structured GDD template and review framework so every design is clear, measurable, and ready for implementation. ## Core Features & Use Cases - Structured GDD Generation: Produces a complete GDD with sections for overview, core loop, mechanics, balance targets, UX flow, open questions, and developer notes. - Design Review Framework: Evaluates existing designs against five pillars: Clarity, Measurability, Feasibility, Fun, and Scope. - Scope Tagging & Dev Handoff: Marks items as [MUST HAVE], [NICE TO HAVE], [POST-LAUNCH], [TBD], or [READY FOR DEV] for clear prioritization. - Use Case: A game designer describes a new daily-reward mechanic and receives a fully formatted GDD section with balance numbers, edge cases, and developer-ready implementation notes. ## Quick Start Write a GDD for a match-3 combo system targeting casual mobile players with 2-minute sessions.

Frequently Asked Questions about gd-write-gdd

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

FAQPage Schema
How do I write a Game Design Document for a new feature?▼

Provide the genre, platform, core player fantasy, and target session length, then the Skill generates a full GDD with overview, core loop, mechanics specification, balance targets, UX flow, open questions, and developer notes.

How to review a game design for gaps and inconsistencies?▼

Submit the existing design and it is checked against five pillars: Clarity, Measurability, Feasibility, Fun, and Scope. Missing balance numbers, vague mechanics, and unresolved decisions are flagged for revision.

What sections should a Game Design Document include?▼

This template includes Overview, Core Loop, Mechanics Specification, Balance Targets, UX Flow, Open Questions, and Developer Notes. Each mechanic must have exact rules, numbers, and edge cases so developers need no follow-up questions.

Can a GDD be converted into developer-ready technical specs?▼

Yes, the Skill extracts mechanic rules from the design and formats them as implementation notes for the Developer role. Items confirmed as complete are tagged [READY FOR DEV] to signal handoff readiness.

When should I not use a full GDD template?▼

A full GDD is excessive for tiny tweaks or bug-fix-level changes where a short feature note suffices. The template is best suited for new features, systems, or mechanics that require balance targets and cross-team alignment.