design-system

Author game system design documents with cross-system dependency validation.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/johnatas-henrique/overdrive --skill design-system-johnatas-henrique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/johnatas-henrique/overdrive/tree/main/.opencode/skills/design-system
Command: npx skills add https://github.com/johnatas-henrique/overdrive --skill design-system-johnatas-henrique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Game system design documents (GDDs) are often incomplete, inconsistent, or fail to account for cross-system dependencies and pre-existing design decisions, leading to implementation rework, design contradictions, and missed alignment with core game pillars.

Core Features & Use Cases

  • Context-Aware Guided Authoring: Automatically gathers relevant context from existing game docs, systems indexes, entity registries, and dependency GDDs before starting design work to avoid contradictions with established decisions.
  • Retrofit Mode: Fills gaps in existing incomplete GDDs without overwriting any established content, making it easy to update legacy design documents without losing prior work.
  • Cross-System Validation: Built-in dependency mapping, registry conflict checks, and specialist agent coordination for design, balance, and QA to ensure GDDs are implementable and consistent across the entire game.
  • Use Case: A designer building a new vehicle physics system for a racing game can use this skill to pull context from the existing movement system GDD, entity registry entries for vehicle stats, and past consistency failure logs to write a complete, conflict-free GDD aligned with all prior design decisions.

Quick Start

Invoke the design-system skill with the name of the game system you want to design to start the guided, section-by-section GDD authoring workflow.

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 system design document without creating cross-system conflicts?

To write a conflict-free game system design document, you need a guided authoring workflow that automatically gathers context from existing game docs, entity registries, and dependency GDDs before starting. This ensures your new system GDD aligns with pre-existing design decisions and avoids implementation rework.

Can I update an incomplete game design document without overwriting existing content?

You can update an incomplete game design document using a retrofit mode that fills gaps section by section without overwriting established content. This allows you to update legacy GDDs incrementally while preserving prior design work and maintaining consistency.

What is the best way to map dependencies when authoring a game system GDD?

The best way to map dependencies during GDD authoring is to use built-in cross-system validation that checks dependency interfaces and registry values. This detects conflicts early and ensures your game system design is implementable across the entire project.

Does this GDD authoring workflow support specialist review for game balance and testability?

This GDD authoring workflow supports specialist review by coordinating with design, balance, and QA agents. It satisfies requirements for validated GDD output by ensuring mandatory section coverage and testability checks are completed before finalizing the document.

When do I need to use a structured authoring workflow for game system design?

You need a structured authoring workflow for game system design when your project requires validated GDD output with mandatory section coverage and dependency interface mapping. It is essential for preventing design contradictions and missed alignment with core game pillars.

How do I start designing a new system for my game?

To start designing a new system for your game, invoke the design-system skill with the name of the specific game system you want to build. This initiates a guided, section-by-section GDD authoring workflow that validates your design against existing registries.