design-review

Automates evaluation of game design documents for completeness, consistency, and implementability.

Updated Feb 8, 2024
One-click install
npx skills add https://github.com/kay6198835/Game-RPG --skill design-review-kay6198835
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/kay6198835/Game-RPG/tree/main/.claude/skills/design-review
Command: npx skills add https://github.com/kay6198835/Game-RPG --skill design-review-kay6198835

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews a game design document for completeness, internal consistency, implementability, and adherence to project design standards. Run this before handing a design document to programmers.

Core Features & Use Cases

  • Performs a phase-by-phase evaluation of a design document against a defined standard, surfacing gaps in overview, player fantasy, rules, formulas, edge cases, dependencies, tuning knobs, and acceptance criteria.
  • Coordinates internal consistency checks and implementability assessment, highlighting ambiguities, missing details, and potential cross-system conflicts for engineers and designers.
  • Supports depth control through --depth (full, lean, solo), enabling either full specialist delegation or a faster single-session review.

Quick Start

Provide the path to the design document and optionally attach a depth spec like --depth full|lean|solo.

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 completeness and feasibility before programming?

You can check design doc feasibility by running an automated evaluation that highlights missing details, edge cases, and cross-system conflicts. It performs a phase-by-phase assessment of rules, formulas, and dependencies to identify impractical requirements before development.

What is the best way to ensure consistency in a game design document?

Ensuring consistency in a game design document involves coordinating internal consistency checks against defined project standards. This evaluation identifies potential cross-system conflicts and missing details, verifying that rules and formulas align before handing the document to programmers.

How do I evaluate a game design spec against project standards?

Evaluating a game design spec requires a multi-phase review workflow that checks frontmatter presence and assesses overview, player fantasy, rules, and acceptance criteria. This surfaces gaps in dependencies and tuning knobs to confirm adherence to design standards.

Can I run a faster single-session design review without full specialist delegation?

No specific dependencies are required to evaluate game design documents. The automated review workflow operates independently, assessing frontmatter presence and document quality without needing external components or frameworks to function.

What sections should a complete game design document include to pass a design review?

A complete game design document should include an overview, player fantasy, rules, formulas, edge cases, dependencies, tuning knobs, and acceptance criteria. The review evaluates these sections phase-by-phase to ensure frontmatter presence and full engineering readiness.