Verified:GitHub

quick-design

Create lightweight game design specs for small changes with acceptance criteria.

Updated May 13, 2026

Search Tags:#implementation planning #spec writing #game design #design documentation #GDD #balance tuning #mechanics change

Ready to run

npx skills add https://github.com/FrancisVarga/the-dream-machine --skill quick-design-francisvarga

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: quick-design
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/quick-design
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill quick-design-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents small-but-important game changes from turning into vague guesswork or full, time-consuming GDD rewrites.

Core Features & Use Cases

Quick Design Spec creation: Generates a lightweight spec tailored to the change size and category (tuning, tweak, addition, or new small system).
Context-aware drafting: Scans the most relevant existing GDD content and prior quick specs to avoid contradictions and preserve system intent.
Implementation-ready output: Produces clear, programmer-oriented acceptance criteria and (when needed) a precise GDD update request while keeping data values in the correct assets location.

Quick Start

Tell the AI the change you want to make (e.g., tuning, tweak, addition, or a small standalone system) and ask it to write a quick design spec for it.

Frequently Asked Questions about quick-design

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

FAQPage Schema

How do I write a game design spec for small balance tuning changes?▼

Yes, you can create implementation-ready specs for minor mechanics changes without a full GDD. The Skill generates a lightweight Quick Design Spec with explicit acceptance criteria and precise GDD update requests, saving the output under design/quick-specs.

What is the best way to document a small standalone game system?▼

The best way to document a small standalone game system is generating a Quick Design Spec. This lightweight document provides programmer-oriented acceptance criteria and categorization tailored for systems that take under about one week to implement.

How do I ensure quick design specs align with existing game design documentation?▼

To ensure quick design specs align with existing game design documentation, the Skill scans your most relevant existing GDD content and prior quick specs. This context-aware drafting process avoids contradictions and preserves system intent.

When should I use a quick design spec instead of updating the full GDD?▼

You should use a quick design spec instead of updating the full GDD when handling tuning adjustments, small behavioral tweaks, or minor mechanic additions under one week. It prevents small changes from becoming time-consuming GDD rewrites while remaining implementation-ready.

Does writing a quick design spec include programmer acceptance criteria?▼

Yes, writing a quick design spec includes programmer acceptance criteria. The output is implementation-ready, providing clear criteria for developers and, when needed, precise guidance on updating data values in the correct assets location.