design-review

Validate game design documents for completeness, consistency, and implementability.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/scomofo/dragon-forge --skill design-review-scomofo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/scomofo/dragon-forge/tree/main/.agents/skills/design-review
Command: npx skills add https://github.com/scomofo/dragon-forge --skill design-review-scomofo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams prevent time-wasting programmer churn by checking that a game design document is complete, internally consistent, and ready to implement.

Core Features & Use Cases

  • Argument-controlled review depth: run a fast lean review or a fuller review with specialist delegation.
  • Dependency graph validation: verifies that referenced system GDD files exist to avoid broken handoffs.
  • Completeness, consistency, and QA-ready checks: evaluates required sections, formulas/edge cases, implementability, and testable acceptance criteria.

Quick Start

Run /design-review production/epics/hatchery/story-005-dragon-unlock-duplicate-xp-and-shiny-upgrade.md --depth full to review the design document with a full completeness and consistency pass.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I review a game design document for implementation readiness?

Reviewing a GDD for completeness involves checking required sections, validating dependency graphs, verifying formulas and edge cases, and ensuring testable acceptance criteria exist before handing the document to programmers.

What does a GDD consistency check for gameplay systems look for?

A GDD consistency check validates that referenced system design files exist, formulas are sound, edge cases are addressed, and acceptance criteria are testable, ensuring the gameplay systems design is internally consistent.

Can I run a fast lean review instead of a full specialist critique on a design document?

Yes, argument-controlled review depth allows you to run a fast lean review or a full review with specialist delegation, letting you choose a quicker validation pass over structured specialist findings.

How do I validate dependency graphs in game design documents?

Dependency graph validation uses filesystem-based checks to verify that referenced system GDD files exist, preventing broken handoffs and ensuring the gameplay systems design is implementable.

Do I need YAML frontmatter in my design document to run a consistency check?

Yes, YAML frontmatter parsing is required for metadata extraction during the design review workflow, enabling the tool to validate dependencies and evaluate the document's implementability.