Skip to content
Development
Skill

/game-design-review

Review, critique, compare, improve, or stress-test an existing game concept, GDD, mechanic, puzzle, economy, level, theme, emotional arc, interface, narrative, social feature, prototype, pitch, or playtest result. Use when the user asks what is weak, risky, unclear, unbalanced,

From plugin
game-dev-skills
10517 skills4 agents

Claude Code

$ npx -y skills add Yuki001/game-dev-skills --skill game-design-review --agent claude-code

SKILL.md

game-design-review.SKILL.md
name: game-design-review
description: Review, critique, compare, improve, or stress-test an existing game concept, GDD, mechanic, puzzle, economy, level, theme, emotional arc, interface, narrative, social feature, prototype, pitch, or playtest result. Use when the user asks what is weak, risky, unclear, unbalanced, contradictory, insufficiently engaging, or worth validating next in a game design. Produce evidence-based findings, explicit tradeoffs, and the smallest useful prototype or playtest experiment.

Game Design Review

Review a design by tracing how rules and presentation are likely to shape player decisions and experience. Treat the review as a decision aid, not a universal checklist or a substitute for playtesting.

Responsibility boundary

  • Use this skill when a design object or decision already exists and needs examination.
  • This skill is self-contained. Do not assume any other skill, workflow, repository layout, document set, or game engine exists.
  • When the user needs a new formal design document rather than a review, return the clarified direction, constraints, open questions, and validation criteria needed to author it.
  • Do not convert a design recommendation directly into code structure, engine APIs, or implementation tasks.

Review modes

Every review shares the same spine:

1. **Name the review object.** The whole game, one loop, one mechanic, a level, an interface flow, a narrative beat, a social feature, or a production choice. 2. **State the decision at stake.** A choice or testable question; if none exists, the most consequential unresolved assumption. 3. **Build an evidence baseline.** Audience, rules, constraints, prototype behavior, and playtest observations, separating repeated patterns from anecdotes; mark each material statement as `confirmed`, `assumed`, or `unknown`. 4. **Close the review.** Prioritized findings, the smallest useful intervention, and a validation experiment.

The modes differ in how the examination between these ends is executed. Pick the narrowest mode that fits; when in doubt, use the comprehensive review.

Comprehensive review (default)

Use when the direction is chosen, formal materials exist to examine (documents, prototypes, telemetry, or playtest records), and the goal is a full-coverage review for weaknesses, risks, and contradictions.

1. **Exclude, then cover.** Exclude only the references the review object clearly makes irrelevant, keeping at least 6; record each exclusion and its reason, and state the unreviewed domains in the final report. 2. **Batch and delegate.** Group the rest into batches of 2 to 4 related domains, one batch per read-only subagent as described in "Delegating a review to subagents" below; work through the batches sequentially yourself when subagents are unavailable. 3. **Trace effects.** Each batch reader connects each design choice to player information, decision, action, feedback, and consequence, distinguishing symptom from cause. 4. **Merge and reconcile.** Merge duplicates that share a root cause, normalize severity, and run a cross-domain contradiction pass, treating each contradiction as a finding of its own; do not emit one undifferentiated checklist.

Focused review

Use when everything to be reviewed fits in the conversation: the design or the question is short, or exists only as notes or keywords in the user's message, with no formal documents to read.

1. Read 2 or 3 relevant references from the routing table yourself. 2. Trace effects as in the comprehensive review and return only the findings that could change the decision.

Exploratory review

Use when no direction has been chosen yet: the design is too immature for fault-finding, and the goal is to outline candidate directions plus a test that can distinguish them.

1. Identify the player promise and the central uncertainty. 2. Outline 2 or 3 coherent directions. 3. Define a small test that can distinguish them, and stop before expanding into a full design document.

Comparative review

Use when the goal is to choose between 2 or more defined options, whatever their material volume.

1. Apply the same evidence and criteria to every option; do not let one option receive a stricter review. 2. When the comparison spans several domains, you may delegate one subagent per option, each applying the same reference set. 3. Merge the per-option findings as in the comprehensive review.

Delegating a review to subagents

Subagents do not share this conversation, so brief each one with everything it needs:

  • the review object and where to find the design materials;
  • the decision at stake and the evidence baseline, so it does not re-open settled facts;
  • its assigned reference paths, with instruction to read them fully before analyzing;
  • the finding-quality bar below, so findings carry enough substance to merge;
  • the boundary: return design findings and a recommended smallest intervention per batch, not implementation tasks.

Subagent reports may take any form that carries that substance. Never let a subagent's severity or priority pass through unreviewed; merging is your job, not theirs.

Reference routing

| Review concern | Read | Focus | | --- | --- | --- | | Audience, intended experience, motivation, comprehension | `references/experience-and-audience.md` | Player promise, motivation chain, pleasure inventory, learning assumptions, experience gaps | | Core concept, theme, emotion, fantasy, aesthetic identity, curiosity and novelty | `references/concept-theme-and-emotion.md` | Concept clarity, imaginative space, thematic coherence, emotional causes, expressive unity, memorable identity | | Actions, goals, rules, information, agency, complexity and strategy | `references/actions-rules-and-agency.md` | Goal hierarchy, decision quality, performance judgment, rule legibility, structure and state, dominant behavior, systemic character | | Challenge, skill profile, risk, punishment, rewards, progression, economy

Read more
@yuki001
Ships withgame-dev-skills

This is my personal agent skill repository, primarily focused on game development.

10517 skills4 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
105
Star history of Yuki001/game-dev-skills on GitHub, a chart by star-history.com

Other skills on game-dev-skills.

gat-design

gat-design

Design one system within a specific milestone's scope: write the milestone-scoped system GDD, content data, and system art doc,…

gat-milestone

gat-milestone

Plan milestone slices from overview + narrative alone (no system GDDs required), create per-milestone directory skeletons and…

gat-story

gat-story

Develop game story and narrative through one-question-at-a-time writer interviews. Produces narrative docs under gat/narrative/…

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills10d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc12d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about game-design-review.

Which coding agents can use game-design-review?
game-design-review installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.