design-system

Generate structured game design documents with cross-system consistency validation.

Updated Jul 22, 2025
One-click install
npx skills add https://github.com/MichaelSolati/mkai --skill design-system-michaelsolati
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/MichaelSolati/mkai/tree/main/profiles/game-dev/skills/design-system
Command: npx skills add https://github.com/MichaelSolati/mkai --skill design-system-michaelsolati

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Game design teams often produce incomplete, inconsistent game design documents (GDDs) that miss critical sections, contradict existing system rules, or fail to align with established game pillars and engine constraints, leading to costly rework and implementation gaps during game development.

Core Features & Use Cases

  • Structured Section-by-Section Authoring: Walks through 8 mandatory GDD sections (Overview, Player Fantasy, Detailed Design, Formulas, Edge Cases, Dependencies, Tuning Knobs, Acceptance Criteria) incrementally to ensure no required content is missed.
  • Context-Aware Design: Automatically pulls existing game concept docs, system dependencies, entity registry data, and past consistency failure logs to avoid contradictions with already finalized design decisions.
  • Retrofit Mode: Fills gaps in existing incomplete GDDs without overwriting completed content, making it easy to update legacy design documents without starting from scratch. Use Case: A game designer building a new inventory system can use this skill to pull existing item registry data and economy system rules, walk through each required GDD section with guided prompts, and ensure the new design aligns with already finalized crafting and progression systems.

Quick Start

Use the design-system skill to author a complete, consistent GDD for your new player combat system, with all required sections filled via guided prompts and cross-referenced context from your existing game docs.

Frequently Asked Questions about design-system

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

FAQPage Schema
How do I write a game design document without missing required sections?

To write a game design document without missing required sections, you can use guided step-by-step authoring that walks through 8 mandatory GDD sections incrementally, ensuring no critical content like Overview, Player Fantasy, or Formulas is skipped.

What is context-aware game design document authoring?

Context-aware game design document authoring automatically pulls existing game concept docs, system dependencies, entity registry data, and past consistency failure logs to prevent contradictions with already finalized game design decisions and architecture constraints.

Can I update an existing incomplete GDD without overwriting finished content?

You can update an existing incomplete GDD without overwriting finished content by using retrofit mode, which fills gaps in legacy design documents while preserving completed sections, eliminating the need to start from scratch.

What's the best way to ensure cross-system consistency in game design docs?

The best way to ensure cross-system consistency in game design docs is to apply built-in dependency mapping and entity registry conflict checking during authoring, aligning new systems with existing game pillars and engine constraints.

How does dependency mapping work when creating a new game system GDD?

Dependency mapping for a new game system GDD works by pulling existing system rules and entity registry data, such as economy or progression systems, to cross-reference context and validate cross-system consistency during guided design prompts.

When do I need architecture decision records for game design documentation?

You need architecture decision records for game design documentation when validating functional requirements for incremental file writing and ensuring alignment with established engine constraints and finalized system architecture.