Create lightweight, living game design documents for AI-built games.

MITAuto-check passedGame Development

Install Game Design Docs

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill game-design-docs -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins game-design-docs --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/LVTD-LLC/skills/skills/game-design-docs .claude/skills/game-design-docs && 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
game-design-docs
GitHub stars
1.2k
Token cost
~516 tokens
SKILL.md length
206 words
Files
3 (incl. references)
Skills in repo
686
Repo updated
First seen
Licence
MIT

At a glance

Create lightweight, living game design documents for AI-built games.

  • Works in 5 steps: Decide the document's job: alignment,… → Keep stable intent separate from… → Capture decisions, rejected… → …
  • Writing a game design brief
  • SKILL.md covers Source Traceability, Workflow, Required Output and Local References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Game Design Docs is an agent skill from hashgraph-online/awesome-codex-plugins. Create lightweight, living game design documents for AI-built games. Use when writing a game design brief, system spec, feature contract, content schema, implementation handoff, decision log, or when a coding agent needs durable project memory.

Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/core/guide.md` and `workflows/living-design-doc.md`). Compatibility notes: Codex, Claude Code, and other Agent Skills-compatible clients.

It sits in Game Development, covering Game design and Architecture decision records. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is MIT.

When your agent uses it

  • Writing a game design brief
  • Feature contract
  • Implementation handoff
  • A coding agent needs durable project memory

Example prompts

  • “/game-design-docs”

Requirements

  • Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients.

Workflow steps

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

  1. Decide the document's job: alignment, implementation, content production, tuning, playtest, or memory.
  2. Keep stable intent separate from volatile implementation details.
  3. Capture decisions, rejected alternatives, open questions, and validation evidence.
  4. Link specs to code, data, assets, tests, and telemetry when possible.
  5. Update docs after design decisions, not after every small code edit.

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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.

  • Compatibility

    Codex, Claude Code, and other Agent Skills-compatible clients.

    From compatibility in the SKILL.md frontmatter.

Context cost

Game Design Docs loads about 516 tokens when it runs, and up to ~909 if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~516
With references · SKILL.md plus every file in references/, read only if the agent opens them
~909

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

The full file from hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its MIT licence (© hashgraph-online). 206 words, ~516 tokens.

Download SKILL.mdSave it as .claude/skills/game-design-docs/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
game-design-docs
description
Create lightweight, living game design documents for AI-built games. Use when writing a game design brief, system spec, feature contract, content schema, implementation handoff, decision log, or when a coding agent needs durable project memory.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.
license
MIT
metadata.version
0.1.0
metadata.displayName
Game Design Docs
metadata.category
Game Development
metadata.tags
game-design,documentation,specs,ai-agents,production

Game Design Docs

Use this skill to create documents that help an AI game-building agent make consistent decisions across sessions. The document should be short enough to stay current and specific enough to constrain implementation.

Source Traceability

Primary source: The Art of Game Design: A Book of Lenses, Third Edition by Jesse Schell, especially chapter 27 on design documents and team communication. The workflow is transformed and paraphrased.

Supporting source: the rest of the game skill pack, which turns design lenses into implementable briefs.

Workflow

  1. Decide the document's job: alignment, implementation, content production, tuning, playtest, or memory.
  2. Keep stable intent separate from volatile implementation details.
  3. Capture decisions, rejected alternatives, open questions, and validation evidence.
  4. Link specs to code, data, assets, tests, and telemetry when possible.
  5. Update docs after design decisions, not after every small code edit.

Required Output

  • Doc Type: brief, system spec, feature contract, tuning sheet, content schema, playtest report, or decision log.
  • Canonical Sections: concise headings suited to the doc type.
  • Open Questions: unresolved decisions with owner or next evidence.
  • Implementation Contract: what the agent should build, avoid, test, and instrument.
  • Maintenance Rule: when this doc must be updated.

Local References

Before producing a design document, read:

  • references/core/guide.md
  • workflows/living-design-doc.md

© hashgraph-online, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/LVTD-LLC/skills/skills/game-design-docs of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/core/guide.md
  • workflows/living-design-doc.md

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Game Design Docs 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.

Game Design Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Game Design Docs this skillhashgraph-online/awesome-codex-plugins1.2k—~516Automated safety check: PassMIT
Design Change PropagationDonchitos/Claude-Code-Game-Studios26k—~3.6kAutomated safety check: NotesMIT
AdoptDonchitos/Claude-Code-Game-Studios26k—~6.4kAutomated safety check: NotesMIT
Reverse DocumentationDonchitos/Claude-Code-Game-Studios26k—~4kAutomated safety check: PassMIT
Architecture ReviewDonchitos/Claude-Code-Game-Studios26k—~9.8kAutomated safety check: NotesMIT
Story DoneDonchitos/Claude-Code-Game-Studios26k—~11kAutomated safety check: NotesMIT

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 9 days ago
    Game DevelopmentAuto-check: notes
  • Adopt

    Donchitos/Claude-Code-Game-Studios

    Brownfield audit — do existing artifacts actually work?. An agent skill from Donchitos/Claude-Code-Game-Studios.

    26k GitHub stars~6.4k tokensUpdated 9 days ago
    Game DevelopmentAuto-check: notes
  • Reverse Documentation

    Donchitos/Claude-Code-Game-Studios

    Writes the missing GDD section, architecture decision record or concept document by reading existing code and prototypes.

    26k GitHub stars~4k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Architecture Review

    Donchitos/Claude-Code-Game-Studios

    Traceability matrix mapping GDD requirements to ADRs. An agent skill from Donchitos/Claude-Code-Game-Studios.

    26k GitHub stars~9.8k tokensUpdated 9 days ago
    DevelopmentAuto-check: notes
  • Story Done

    Donchitos/Claude-Code-Game-Studios

    End-of-story completion review — verifies each acceptance criterion, checks GDD/ADR deviations, prompts code review, updates status.

    26k GitHub stars~11k tokensUpdated 9 days ago
    DevelopmentAuto-check: notes
  • Gameplay Design Sync

    tangziwen/CubeMiniGame

    Assess whether completed CubeGame gameplay changes should be reconciled into Doc/GameplayIntent design documents.

    359 GitHub stars~1.5k tokensUpdated 19 days ago
    DevelopmentAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Game Design Docs

What does Game Design Docs do?

Create lightweight, living game design documents for AI-built games. Game Design Docs is an agent skill from hashgraph-online/awesome-codex-plugins. Create lightweight, living game design documents for AI-built games.

When should I use Game Design Docs?

Game Design Docs fits situations like: writing a game design brief; feature contract; implementation handoff; A coding agent needs durable project memory.

How do I install Game Design Docs in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill game-design-docs -a claude-code`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/game-design-docs in hashgraph-online/awesome-codex-plugins) into .claude/skills/game-design-docs in your project. Claude Code loads it when a task matches its description.

How do I install Game Design Docs in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill game-design-docs -a codex`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/game-design-docs in hashgraph-online/awesome-codex-plugins) into .agents/skills/game-design-docs in your project. Codex loads it when a task matches its description.

Can I use Game Design Docs 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 hashgraph-online/awesome-codex-plugins --skill game-design-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/game-design-docs, .gemini/skills/game-design-docs, .github/skills/game-design-docs and .opencode/skills/game-design-docs in your project.

What does Game Design Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Game Design Docs is instructions for the agent only. Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients..

Does Game Design Docs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Game Design Docs 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 Game Design Docs use?

Game Design Docs is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Game Design Docs use?

About 516 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 393 tokens, read only when the agent opens those files.

What are the alternatives to Game Design Docs?

Skills that share tags, products or a category with Game Design Docs: Design Change Propagation (Donchitos/Claude-Code-Game-Studios, 26k stars), Adopt (Donchitos/Claude-Code-Game-Studios, 26k stars), Reverse Documentation (Donchitos/Claude-Code-Game-Studios, 26k stars) and Architecture Review (Donchitos/Claude-Code-Game-Studios, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Game Design Docs?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.