Game Design Document phase for one tag. An agent skill from RandallLiuXin/GodotMaker.

Custom licenceAuto-check passedGame Development

Install Gm Gdd

skills CLI
$ npx skills add RandallLiuXin/GodotMaker --skill gm-gdd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install RandallLiuXin/GodotMaker gm-gdd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/RandallLiuXin/GodotMaker.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/core/gm-gdd .claude/skills/gm-gdd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gm-gdd
GitHub stars
550
Token cost
~4.7k tokens
SKILL.md length
2,241 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
Custom licence

At a glance

Game Design Document phase for one tag. An agent skill from RandallLiuXin/GodotMaker.

  • Works in 4 steps: Read ROADMAP.md, list tag entries in… → Run git tag --list 'v*' (capture stdout). → The current tag is the earliest tag in… → …
  • Tasks that involve Game design
  • SKILL.md covers Session Setup, Resume Check, Mode Detection and Freeform Intake, plus 4 more sections
  • Calls git and python

What it does

Gm Gdd is an agent skill from RandallLiuXin/GodotMaker. Game Design Document phase for one tag. On the first ever run, runs the full Socratic interview, produces GDD.md, and derives ROADMAP.md (split into SemVer-tagged release tags). On every subsequent run, focuses the conversation on the current tag (the earliest entry in ROADMAP.md without a git tag), optionally updates GDD.md / ROADMAP.md, then generates the current tag's PLAN/STRUCTURE/SCENES/DESIGN/ASSETS at the project root. Explicit invocation only — use /gm-gdd.

Its SKILL.md is about 4.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Game design. It works with Git. The repository describes itself as: Autonomous text-to-game pipeline for Godot, powered by Claude Code,Codex,Opencode.

When your agent uses it

  • Tasks that involve Game design

Example prompts

  • “/gm-gdd”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read ROADMAP.md, list tag entries in declared order.
  2. Run git tag --list 'v*' (capture stdout).
  3. The current tag is the earliest tag in ROADMAP that is not in git tag --list.
  4. If every ROADMAP entry already has a git tag, STOP and inform the user the roadmap is exhausted — they must edit ROADMAP.md to add new…

What it can do on your machine

Read from SKILL.md and the folder at commit 1d4702c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gm Gdd loads about 4.7k tokens when it runs. Until then it costs about 119 tokens; SKILL.md has 2,241 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,241 words (~4,707 tokens).

name
gm-gdd
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/core/gm-gdd of RandallLiuXin/GodotMaker.

Open the folder on GitHubat commit 1d4702c

Compare with similar skills

Gm Gdd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gm Gdd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gm Gdd this skillRandallLiuXin/GodotMaker550—~4.7kAutomated safety check: PassCustom licence
Design Change PropagationDonchitos/Claude-Code-Game-Studios26k—~3.6kAutomated safety check: NotesMIT
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
Threejs Gameplay Systemscorosolto/client257—~1.5kAutomated safety check: PassAGPL-3.0
Roblox Gamebrockmartin/roblox-game-skill203—~1.3kAutomated safety check: PassNone

Similar skills

  • Design Change Propagation

    Donchitos/Claude-Code-Game-Studios

    Finds architecture decision records made stale by a changed game design document, then reports the impact and guides you through resolving each one.

    26k GitHub stars~3.6k tokensUpdated 3 days ago
    Game DevelopmentAuto-check: notes
  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Game DevelopmentAuto-check passed
  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • Threejs Gameplay Systems

    corosolto/client

    Build and iterate playable Three.js game systems. An agent skill from corosolto/client.

    257 GitHub stars~1.5k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Roblox Game

    brockmartin/roblox-game-skill

    Expert Roblox game development companion — Luau, Roblox Studio, MCP integration, simulator, tycoon, obby, RPG, horror, battle royale, game design, security, performance.

    203 GitHub stars~1.3k tokensUpdated 7 mo ago
    Game DevelopmentAuto-check passed
  • Design

    vladikk/modularity

    Designs modular high-level architectures from functional requirements and produces design documents for each module.

    555 GitHub stars~3.8k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed

More from RandallLiuXin/GodotMaker

All 41 skills in this repo
  • Godot E2E

    RandallLiuXin/GodotMaker

    Write and run E2E (end-to-end) game tests using the godot-e2e framework.

    550 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed
  • MCP Driver

    RandallLiuXin/GodotMaker

    Runtime debugging and live project inspection via godot-mcp.

    550 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Gecs

    RandallLiuXin/GodotMaker

    gecs ECS framework API reference — the Entity-Component-System addon for Godot 4.x used by this project.

    550 GitHub stars~2.7k tokensUpdated 23 days ago
    Auto-check passed
  • Gdtoolkit

    RandallLiuXin/GodotMaker

    Lint and format GDScript files using gdtoolkit (gdlint + gdformat).

    550 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Project Scaffold

    RandallLiuXin/GodotMaker

    Generate a new Godot game project with standardized ECS structure and tooling.

    550 GitHub stars~2.1k tokensUpdated 23 days ago
    Auto-check passed
  • Gdunit Driver

    RandallLiuXin/GodotMaker

    Run gdUnit4 unit tests and parse results into structured output.

    550 GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed

Works with

Questions about Gm Gdd

What does Gm Gdd do?

Game Design Document phase for one tag. An agent skill from RandallLiuXin/GodotMaker. Gm Gdd is an agent skill from RandallLiuXin/GodotMaker. Game Design Document phase for one tag.

When should I use Gm Gdd?

Gm Gdd fits situations like: tasks that involve Game design.

How do I install Gm Gdd in Claude Code?

Run `npx skills add RandallLiuXin/GodotMaker --skill gm-gdd -a claude-code`. Or copy the skill folder (skills/core/gm-gdd in RandallLiuXin/GodotMaker) into .claude/skills/gm-gdd in your project. Claude Code loads it when a task matches its description.

How do I install Gm Gdd in Codex?

Run `npx skills add RandallLiuXin/GodotMaker --skill gm-gdd -a codex`. Or copy the skill folder (skills/core/gm-gdd in RandallLiuXin/GodotMaker) into .agents/skills/gm-gdd in your project. Codex loads it when a task matches its description.

Can I use Gm Gdd in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add RandallLiuXin/GodotMaker --skill gm-gdd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gm-gdd, .gemini/skills/gm-gdd, .github/skills/gm-gdd and .opencode/skills/gm-gdd in your project.

What does Gm Gdd need to run?

Going by SKILL.md and its folder, Gm Gdd needs the command-line tools its instructions call (git and python).

Does Gm Gdd access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Gm Gdd safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gm Gdd use?

Gm Gdd has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Gm Gdd use?

About 4.7k tokens (SKILL.md is roughly 19k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gm Gdd?

Skills that share tags, products or a category with Gm Gdd: Design Change Propagation (Donchitos/Claude-Code-Game-Studios, 26k stars), Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars), Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars) and Threejs Gameplay Systems (corosolto/client, 257 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gm Gdd?

RandallLiuXin (a GitHub user) maintains it in RandallLiuXin/GodotMaker, which has 550 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on September 17, 2026.

Source: RandallLiuXin/GodotMaker on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.