whatisgithub

What is game-design-skills?

apetrovcode/game-design-skills — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

game-design-skills adds two Claude Code skills that audit any game's balance using real graph theory computation, then propose and verify redesigns.

Mindmap

mindmap
  root((game-design-skills))
    What it does
      Audits game balance
      Proposes redesigns
      Verifies with graph theory
      Blind re-audit loop
    Tech stack
      Python
      Claude Code skills
    Use cases
      Game balance audit
      Theory tested redesign
      Independent re-audit
    Audience
      Game designers
      Developers
      Claude Code users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Audit a published game or your own design document for balance problems using graph theory computation.

USE CASE 2

Generate theory tested redesign proposals for a game, verified against the same math engine.

USE CASE 3

Run a blind re-audit in a fresh session to independently check a proposed redesign.

What is it built with?

PythonClaude Code

How does it compare?

apetrovcode/game-design-skills0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Claude Code and Python 3 with no extra packages to install.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

game-design-skills is a pair of add ons for Claude Code, the command line coding assistant, that turn a chat conversation into a tool for analyzing and improving game designs. The first skill, game-analysis, examines any game, whether it is a published title, your own design document, rules text, or prototype code, and reports what kind of game it is, what makes it enjoyable, and what parts of its design might be broken. The second skill, game-redesign, takes that audit and proposes bold new versions of the game, including new mechanics and rebalanced interaction charts, then checks each proposal against the same underlying math before handing back a specification meant to be reviewed again from scratch. What sets this apart from a simple prompt is that both skills route their important balance claims through a small, dependency free Python script that actually computes things rather than guessing: it detects cycles in how game choices beat each other, finds strategies that are always worse than another option, searches for combinations of choices that together cannot be beaten, and calculates viability scores using a technique called eigenvector centrality. So when the tool claims there are no dominated strategies, or that a certain balance property holds, that is a result you can rerun and verify yourself using the included examples, one of which walks through classic rock paper scissors as a demonstration. The project includes a folder of real, unedited example runs showing the full loop of auditing a game, proposing redesigns, and then having a separate, memory free session independently re-check the proposal, including cases where the re-audit catches a real design gap the original session missed, and a case showing the tool correctly declines to force a mathematical structure onto a game like Tetris that does not have one. Installing it requires Claude Code and Python 3 already on your machine, since it uses only Python's standard library. The knowledge base behind the skills is meant to be swappable, so someone could replace the built in design theory notes with their own framework. The author is upfront that the tool can prove a design is not mathematically broken but cannot judge whether a game actually feels fun, so playtesting still matters. This project is aimed at game designers and developers using Claude Code. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Install game-design-skills and use the game-analysis skill to audit rock paper scissors for me.
Prompt 2
Explain how the matrix analysis script detects dominated strategies and unbeatable subsets.
Prompt 3
Walk me through the analyze, redesign, and blind re-audit loop this project implements.
Prompt 4
How would I swap in my own game design theory notes to replace the built in framework?

Frequently asked questions

What is game-design-skills?

game-design-skills adds two Claude Code skills that audit any game's balance using real graph theory computation, then propose and verify redesigns.

What language is game-design-skills written in?

Mainly Python. The stack also includes Python, Claude Code.

What license does game-design-skills use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is game-design-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is game-design-skills for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.