game-design-doc

Community

Lightweight game design specs for small changes.

AuthorMichaelSolati
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Writing full Game Design Documents (GDDs) for small, low-risk changes like balance tweaks or minor mechanic adjustments wastes valuable development time. This skill removes that overhead by providing a fast, structured workflow to create concise, actionable design specs for small changes in minutes.

Core Features & Use Cases

  • Intelligent Change Classification: Automatically categorizes changes into tuning, tweaks, additions, or new small systems to apply the correct spec template and avoid over-documentation.
  • Context-Aware Drafting: Scans existing GDDs and prior quick specs to ensure new specs align with established game systems and avoid contradictions.
  • Structured, Implementation-Ready Output: Generates formatted quick design specs with clear change rationale, testable acceptance criteria, and GDD cross-references for seamless handoff to development teams.
  • Real-World Use Case: For example, if you want to increase a character's jump height by 1 unit to improve platforming feel, this skill will generate a complete spec with old/new values, rationale, and test criteria without requiring a full GDD rewrite.

Quick Start

Use the game-design-doc skill to create a quick design spec for increasing the player's jump height by 1 unit.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: game-design-doc
Download link: https://github.com/MichaelSolati/mkai/archive/main.zip#game-design-doc

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 537,000+ vetted skills library on demand.