Agent skill

Game Build From Design

by zenstory-ai in zenstory-ai/novel-to-game

Builds a risk-matched whitebox or an approved production game candidate from a game design for its target runtime, with replayable evidence.

MITAuto-check passedGame Development

SKILL.md written in Chinese; this summary is our English description.

Install Game Build From Design

skills CLI
$ npx skills add zenstory-ai/novel-to-game --skill game-build -a claude-code

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

GitHub CLI
$ gh skill install zenstory-ai/novel-to-game game-build --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/zenstory-ai/novel-to-game.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/game-build .claude/skills/game-build && 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-build
GitHub stars
841
Token cost
~661 tokens
SKILL.md length
128 words
Files
7 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Builds a risk-matched whitebox or an approved production game candidate from a game design for its target runtime, with replayable evidence.

  • Works in 4 steps: 先实现一个最小但完整的核心循环:启动、真实输入、状态变化、结果和重开。范围不足时修… → 实现 GAME_DESIGN… → 保留能复现问题的初态与输入路径,涉及随机性时固定… → …
  • Prototyping the riskiest question in a game design as a whitebox
  • SKILL.md covers 目标与自由, 按能力读取可选合同, 共同构建循环 and 输出
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill, documented in Chinese, builds a runnable game candidate from an approved design in one of two stages. The whitebox stage tests the riskiest design question in the form that exposes it, and the production stage implements the approved game design and art direction for the target runtime named in the product brief. It must not redo concept, level or art direction during the build.

Inputs are the game design file and, for a full candidate, an art direction file; missing product decisions go back to their owners. The agent declares a build stage and a build path (template or custom), compresses the product boundary, experience facts and completion evidence into a short build brief, and implements a minimal complete core loop of start, real input, state change, result and restart. When a generative model is used, it only interprets input and results while a rules engine owns what gets committed.

Failures are kept replayable with saved initial state, input paths and fixed seeds. Optional contracts cover Blender assets, playable model rules, voice production and generative media. Production adds one authoritative verification command so a QA skill can walk a clean start, core action, designed result and restart, and the output is a build brief plus the candidate.

When your agent uses it

  • Prototyping the riskiest question in a game design as a whitebox
  • Implementing an approved game design for its target runtime
  • Writing a minimal build brief from a design document
  • Making a game candidate replayable so QA can verify it

Example prompts

  • “Prototype the riskiest design question from GAME_DESIGN.md as a whitebox.”
  • “Turn the approved game design and art direction into a runnable production candidate.”
  • “Write the build brief for this design and build the candidate for the target runtime in the product brief.”

Requirements

  • A GAME_DESIGN.md file, plus ART_DIRECTION.md for a full production candidate

Workflow steps

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

  1. 先实现一个最小但完整的核心循环:启动、真实输入、状态变化、结果和重开。范围不足时修范围,
  2. 实现 GAME_DESIGN 的状态、动作与结果;使用生成模型时,模型只解释输入和结果,规则器拥有提交权。
  3. 保留能复现问题的初态与输入路径,涉及随机性时固定 seed;修订后重放失败路径与相邻反例。
  4. 回写实际工具链、install/build/start 命令和版本;未知值写 NOT_AVAILABLE: 原因,不猜。

What it can do on your machine

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

Context cost

Game Build From Design loads about 661 tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 127 tokens; SKILL.md has 128 words of instructions outside code blocks.

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

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 zenstory-ai/novel-to-game at commit 03feee9, republished under its MIT licence (© zenstory-ai). 128 words, ~661 tokens.

Download SKILL.mdSave it as .claude/skills/game-build/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
game-build
description
Build a risk-matched whitebox or the approved production game for its target runtime. Turn GAME_DESIGN, and ART_DIRECTION when production begins, into a minimal BUILD_BRIEF and a runnable candidate that can be iterated with replayable evidence. Use for prototype the riskiest design question, implement the approved game design, or turn this design into a running game. 游戏构建执行。先按最大风险做白盒,或在正式生产时把批准后的 GAME_DESIGN 与 ART_DIRECTION 压缩成最小 BUILD_BRIEF,在目标运行环境中实现可运行候选并用可回放证据迭代。用于验证高风险设计问题、构建游戏原型或实现批准方案。

游戏构建执行

保护已批准的体验边界;正式生产时再保护已批准的美术边界。驱动实现模型完成真实可玩的候选,不在 构建阶段重新做概念、关卡或美术方向。

读取 build-brief-contract.md。白盒阶段必须已有 GAME_DESIGN.md; 完整候选还必须已有 ART_DIRECTION.md。缺产品决定时回对应 owner,不在 BUILD_BRIEF 就地发明。

产物语言由 PRODUCT_BRIEF.md 锁定;未锁定时跟随对话语言,不默认产出中文。

目标与自由

按 PRODUCT_BRIEF 锁定的平台、生产引擎、目标运行时、显示/输入、范围、分级和联网边界交付。 目标工具链不可用时不得自动改做网页;只有 brief 已批准替代运行时才可使用,并分开记录 targetRuntime、testedRuntime 与未覆盖项。

正式生产继承 ART_DIRECTION.md 的可观察视觉约束与批准目标图,在实际运行中验证焦点资产。

BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式与完成证据,实现细节交给实现模型。

先声明 buildStage: whitebox|production 与 buildPath: template|custom。已有交互语法只有在能保留原作 独有动作、代价和世界回应时才采用;实时手感、空间、视线、物理或模板覆盖不了的核心动词走 custom。 白盒也必须选择能验证最大风险的形态,不能把所有项目降成文游。

当前会话能编码时直接实现;外部模型不可用时只交付构建说明,不声称游戏已生成。不要发送与原型 无关的完整受版权保护原文。

按能力读取可选合同

共同构建循环

  1. 先实现一个最小但完整的核心循环:启动、真实输入、状态变化、结果和重开。范围不足时修范围, 不先堆审计材料。
  2. 实现 GAME_DESIGN 的状态、动作与结果;使用生成模型时,模型只解释输入和结果,规则器拥有提交权。 存在 signature_command 时再执行可选合同的专属边界。
  3. 保留能复现问题的初态与输入路径,涉及随机性时固定 seed;修订后重放失败路径与相邻反例。
  4. 回写实际工具链、install/build/start 命令和版本;未知值写 NOT_AVAILABLE: 原因,不猜。 实际候选与 GAME_DESIGN、ART_DIRECTION 的事实描述不符时,交回对应 owner 修订或在 BUILD_BRIEF 标明冲突, 不留下描述已不存在的玩法、表现或声音的文档。

whitebox 到此按 build-brief-contract「完成证据」运行最窄检查并交回 design owner;设计修订后 重放受影响路径,直到最大风险已被实际暴露或当前方向被否决。

production 继续:

  1. 提供一条权威验证命令和最小可观察状态,使 game-qa 能一次走完 clean start → 核心动作 → 设计结果 → restart。
  2. 运行最窄的开发检查与启动 smoke,修复构建失败、阻断日志、资源失败和崩溃;替代运行时未覆盖的 目标平台输入、性能、打包或设备项写入 limitation。
  3. 达到 brief 的 targetFinish;更高完成度只处理已批准的焦点资产和招牌时刻,不制造与可玩闭环 无关的发布审计。
  4. 交给 game-qa;诊断、复跑与事实源规则见契约「完成证据」。

输出

生成 build/BUILD_BRIEF.md 与实际候选;production 还生成权威验证入口。截图、录制与 raw trace 只保留 调试所需的最小集合。

© zenstory-ai, 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 6 other files (references) in skills/game-build of zenstory-ai/novel-to-game.

  • SKILL.md
  • agents/openai.yaml
  • references/blender-asset-workflow.md
  • references/build-brief-contract.md
  • references/generative-media-pipeline.md
  • references/playable-model-contract.md
  • references/tts-production-contract.md

Open the folder on GitHubat commit 03feee9

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in zenstory-ai/novel-to-game, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Game Build From Design 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 Build From Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Game Build From Design this skillzenstory-ai/novel-to-game841—~661Automated safety check: PassMIT
Game Designericrisco/rsc-harness180—~3.6kAutomated safety check: PassMIT
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
Asset Pipelinerehan-remade/universal-modder6.5k—~2kAutomated safety check: PassMIT
Blender Image To 3Dmajidmanzarpour/blender-game-skills135—~5.7kAutomated safety check: PassMIT
Text To 3D AssetLaurentiuGabriel/unreal-game-assets-creation-skill148—~2.1kAutomated safety check: PassNone

Similar skills

  • Game Design

    ericrisco/rsc-harness

    A skill your agent uses when designing or repairing what makes a game fun — verbs and mechanics, moment-to-moment/session/meta loops, progression, economy faucets and sinks, difficulty curves…

    180 GitHub stars~3.6k tokensUpdated yesterday
    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
  • Asset Pipeline

    rehan-remade/universal-modder

    Turn generated or hand-made art into exactly what a game engine loads.

    6.5k GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Blender Image To 3D

    majidmanzarpour/blender-game-skills

    Build a game-ready 3D asset in Blender from reference images (concept art, photos, turnarounds, sketches, screenshots) for any category, including characters, creatures, architecture, vehicles…

    135 GitHub stars~5.7k tokensUpdated 17 days ago
    Game DevelopmentAuto-check passed
  • Text To 3D Asset

    LaurentiuGabriel/unreal-game-assets-creation-skill

    Generate a game-ready 3D asset by running the local AI pipeline sequentially: Fooocus (SDXL text-to-image) - Hunyuan3D-2 (image-to-textured-GLB) - optional Blender FBX convert + Unreal import.

    148 GitHub stars~2.1k tokensUpdated 2 mo ago
    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

More from zenstory-ai/novel-to-game

  • Novel Game Adaptation Analysis

    zenstory-ai/novel-to-game

    Condenses a novel or its deconstruction notes into a cited SOURCE_BIBLE of world rules, player verbs, spaces and systems, before any game genre is chosen.

    841 GitHub stars~558 tokensUpdated 8 days ago
    Auto-check passed
  • Novel to Game

    zenstory-ai/novel-to-game

    Orchestrates turning a novel in any language into a playable game, from requirements intake and source-grounded analysis through design, build and QA.

    841 GitHub stars~567 tokensUpdated 8 days ago
    Auto-check passed
  • Game Art Direction

    zenstory-ai/novel-to-game

    Turns a game design document into an art direction document covering visual identity, HUD and feedback, sound direction and the key in-game moments.

    841 GitHub stars~384 tokensUpdated 8 days ago
    Auto-check passed
  • Novel-to-Game Concept Design

    zenstory-ai/novel-to-game

    Compares game concepts for adapting a novel, rules out weak ones with hard vetoes and writes the chosen playable direction to a CONCEPT.md file.

    841 GitHub stars~423 tokensUpdated 8 days ago
    Auto-check passed
  • Evidence-Based Game QA

    zenstory-ai/novel-to-game

    Verifies a game build on its target runtime with real run evidence for launch, rendering, input, core loop, outcome and restart, and records limitations honestly.

    841 GitHub stars~389 tokensUpdated 8 days ago
    Auto-check passed
  • Game World Design

    zenstory-ai/novel-to-game

    Turns a chosen game concept into one GAME_DESIGN document covering the core loop, world rules, level beats, feedback, failure and a playable-slice contract.

    841 GitHub stars~495 tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Game Build From Design

What does Game Build From Design do?

Builds a risk-matched whitebox or an approved production game candidate from a game design for its target runtime, with replayable evidence. This skill, documented in Chinese, builds a runnable game candidate from an approved design in one of two stages. The whitebox stage tests the riskiest design question in the form that exposes it, and the production stage implements the approved game design and art direction for the target runtime named in the product brief.

When should I use Game Build From Design?

Game Build From Design fits situations like: prototyping the riskiest question in a game design as a whitebox; implementing an approved game design for its target runtime; writing a minimal build brief from a design document; making a game candidate replayable so QA can verify it.

How do I install Game Build From Design in Claude Code?

Run `npx skills add zenstory-ai/novel-to-game --skill game-build -a claude-code`. Or copy the skill folder (skills/game-build in zenstory-ai/novel-to-game) into .claude/skills/game-build in your project. Claude Code loads it when a task matches its description.

How do I install Game Build From Design in Codex?

Run `npx skills add zenstory-ai/novel-to-game --skill game-build -a codex`. Or copy the skill folder (skills/game-build in zenstory-ai/novel-to-game) into .agents/skills/game-build in your project. Codex loads it when a task matches its description.

Can I use Game Build From Design 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 zenstory-ai/novel-to-game --skill game-build -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-build, .gemini/skills/game-build, .github/skills/game-build and .opencode/skills/game-build in your project.

What does Game Build From Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Game Build From Design is instructions for the agent only. Our summary lists: A GAME_DESIGN.md file, plus ART_DIRECTION.md for a full production candidate.

Does Game Build From Design 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 Build From Design 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 Build From Design use?

Game Build From Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Game Build From Design use?

About 661 tokens (SKILL.md is roughly 2.6k 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 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Game Build From Design?

Skills that share tags, products or a category with Game Build From Design: Game Design (ericrisco/rsc-harness, 180 stars), Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars), Asset Pipeline (rehan-remade/universal-modder, 6.5k stars) and Blender Image To 3D (majidmanzarpour/blender-game-skills, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Game Build From Design?

zenstory-ai (a GitHub organization) maintains it in zenstory-ai/novel-to-game, which has 841 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 3, 2026.

Source: zenstory-ai/novel-to-game on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.