skills.rest
FrancisVarga
FrancisVargaCOMMUNITY
Explore all skills by this author →
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
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill quick-design-francisvarga
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Design & Creative Skills→
striderZAstriderZA
72

quick-design

Generate lightweight design specifications for small game changes with acceptance criteria.

Community
Intermediate
CarlosQ96CarlosQ96

quick-design

Generate a markdown Quick Design Spec for minor game changes.

Community
Intermediate
MichaelSolatiMichaelSolati

game-design-doc

Generate quick design specs for small game changes with acceptance criteria.

Community
Intermediate
sumilee-pcusumilee-pcu

quick-design

Generate lightweight design specs for minor game mechanics and balance adjustments.

Community
Intermediate