quick-design

Generates lightweight design specs for small game changes like tuning and tweaks.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill quick-design-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quick-design
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/quick-design
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill quick-design-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full Game Design Document for every small change—like adjusting jump height or adding a parry window—wastes time, yet implementing changes with no written rationale causes confusion and contradictions. This Skill provides a middle path: a structured Quick Design Spec for changes too small for a full GDD but too meaningful to implement undocumented. ## Core Features & Use Cases - Change Classification: Categorizes requests as Tuning, Tweak, Addition, or New Small System, and redirects oversized changes to the full GDD pipeline. - Context Scanning: Reads existing GDDs, the systems index, and prior quick specs to avoid contradictions before drafting. - Tailored Spec Templates: Produces category-specific Markdown specs with tuning tables, design deltas, acceptance criteria, and GDD update flags, saved to design/quick-specs/. - Use Case: A designer wants to increase jump height from 5 to 6 units. The Skill classifies it as Tuning, checks the GDD's Tuning Knobs section, and writes a dated spec with old/new values, rationale, and testable acceptance criteria. ## Quick Start Use the quick-design skill to create a lightweight design spec for increasing enemy patrol speed by 10 percent.

Frequently Asked Questions about quick-design

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

FAQPage Schema
How do I document a small game design change without writing a full GDD?

Use a Quick Design Spec, a trimmed Markdown document covering the change summary, motivation, new rules, and acceptance criteria. It is saved to design/quick-specs/ with a dated kebab-case filename and embeds directly into story files.

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

Use a quick spec for tuning changes, small tweaks, minor additions, or standalone systems under roughly one week of work. Redirect to full GDD authoring when the change adds cross-system dependencies, alters core rules, or exceeds one week of implementation.

What change types does the quick design workflow support?

It supports four categories: Tuning (number changes only), Tweak (small behavioral change), Addition (a small new mechanic on an existing system), and New Small System (a standalone feature). Each category uses a tailored spec template.

Does a quick design spec require the full design review pipeline?

No. Quick Design Specs bypass design-review and review-all-gdds by design, since they cover small, low-risk changes. They should still be referenced in the story's GDD Reference field and validated with story-readiness before implementation.

Can a quick spec update an existing GDD?

Yes, but only with explicit approval. The spec flags whether a GDD update is required, shows the exact old versus new text for the affected section, and asks for confirmation before editing the GDD file.