design-system

Guide section-by-section game system GDD authoring from requirements to acceptance criteria.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill design-system-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/design-system
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill design-system-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the risk of creating incomplete or inconsistent design documentation by guiding you through a section-by-section GDD workflow and grounding the draft in existing project context.

Core Features & Use Cases

  • Guided, section-by-section GDD authoring: walks you through each required section for a single game system.
  • Context-aware drafting: gathers required reads like the game concept, systems index, entity registry (when present), and past consistency failures to avoid contradicting prior decisions.
  • Dependency-respecting design: identifies upstream/downstream systems and incorporates their constraints so your GDD matches established interfaces, assumptions, and expectations.
  • Incremental writing with retrofit safety: supports a retrofit workflow that can fill only missing or placeholder content without overwriting completed sections.

Quick Start

Use the design-system skill to create a new GDD for your system by running: /design-system movement

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 for a new system without contradicting existing mechanics?

To write a game design document without contradictions, use a context-aware authoring workflow that gathers existing game concepts, systems indexes, and entity registries to ground your drafting process. This ensures new system designs respect prior decisions and established interfaces.

What is a retrofit workflow for incomplete game design docs?

A retrofit workflow for game design docs is a non-destructive editing process that fills only missing or placeholder content in partially written GDDs. It safely completes required sections without overwriting your previously finalized documentation.

How do I ensure my game system GDD captures upstream and downstream dependencies?

To ensure your game system GDD captures dependencies, apply dependency-aware writing that identifies upstream and downstream systems. This incorporates their constraints and assumptions so your design matches established interfaces and expectations.

Can I use dependency-aware writing to pass a strict review mode for game design docs?

Yes, dependency-aware writing supports deterministic review-mode handling by ensuring strict required-section coverage across incremental phases. It validates that your game design doc satisfies all acceptance criteria and captures open questions accurately.

What is the best way to structure a game system GDD from requirements to acceptance criteria?

The best way to structure a game system GDD is through guided, section-by-section authoring across incremental phases. This workflow systematically progresses from initial requirements through acceptance criteria and open questions, ensuring complete required-section coverage.

Do I need a game concept and systems index before starting guided GDD authoring?

Yes, you need a game concept and systems index as required reads before starting guided GDD authoring. These project context documents provide the necessary foundation to draft consistently and avoid contradicting prior design decisions.