Agent skill

Game World Design

by zenstory-ai in 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.

MITAuto-check passedGame Development

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

Install Game World Design

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

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

GitHub CLI
$ gh skill install zenstory-ai/novel-to-game game-world-design --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-world-design .claude/skills/game-world-design && 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-world-design
GitHub stars
841
Token cost
~495 tokens
SKILL.md length
61 words
Files
5 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 8 steps: 体验与循环合同:玩家身份、承诺、目标感受、experienceProfile、核心… → 世界规则与进程:玩家可见/隐藏信息、行动顺序、随机性、资源或持久状态及其读取点; → 决策与关卡节拍:关键局面如何要求玩家行动或取舍,玩家拥有何种因果权与结算权; → …
  • Turning a selected game concept into a design document with a core loop and level pacing
  • SKILL.md covers 设计原则, 输出合同 and 完成检查
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Written in Chinese, this skill takes three input files, `SOURCE_BIBLE.md`, the selected `CONCEPT.md` and `PRODUCT_BRIEF.md`, and produces a compact `design/GAME_DESIGN.md` that turns the concept into a player experience a team can build. It deliberately avoids world-lore encyclopedias, engineering plans, art direction, file names, functions, shaders and asset pipelines.

The document has eight parts: the experience and loop contract; world rules and progression; decision and level beats; feedback, failure and restart; a narrative appendix used only when story carries the experience; language, culture and handoff limits; an executable slice contract; and a verification slice. Method notes for world, numeric and narrative design live in three reference files, read when resources, difficulty gates or story actually matter. The output language follows `PRODUCT_BRIEF.md`, or the conversation if the brief does not lock one, and the result goes back to the main entry skill rather than moving on to art, build or QA.

When your agent uses it

  • Turning a selected game concept into a design document with a core loop and level pacing
  • Designing how the game world responds to player actions and what happens on failure
  • Planning branching scenes, dialogue and consequences when story drives the gameplay
  • Defining a playable prototype slice and what it should validate

Example prompts

  • “Write the GAME_DESIGN for the concept we picked, using our SOURCE_BIBLE and PRODUCT_BRIEF.”
  • “Design level pacing and the failure and restart rules for the first playable slice.”
  • “Add a branching narrative section with scenes, dialogue and consequences to the design doc.”

Requirements

  • SOURCE_BIBLE.md, CONCEPT.md and PRODUCT_BRIEF.md from earlier project stages

Workflow steps

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

  1. 体验与循环合同:玩家身份、承诺、目标感受、experienceProfile、核心动作与循环和主要玩法先例,
  2. 世界规则与进程:玩家可见/隐藏信息、行动顺序、随机性、资源或持久状态及其读取点;
  3. 决策与关卡节拍:关键局面如何要求玩家行动或取舍,玩家拥有何种因果权与结算权;
  4. 反馈、失败与重开:输入反馈、状态变化、失败原因、下次可改之处和定义初态;
  5. 叙事附件:仅在叙事实际承载体验时写场景脊柱、人物议程、知识/证词边界、持久回响、
  6. 语言、文化与交接边界:界面语言、术语、阅读顺序、内容尺度,以及交给美术和构建的玩家效果;
  7. 可执行切片合同:最大设计风险、匹配的原型形态、最小状态、动作前置/效果,以及初态、输入路径、
  8. 验证切片:范围、明确非目标、完整路径和会触发设计修改的观察结果。

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 World Design loads about 495 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 138 tokens; SKILL.md has 61 words of instructions outside code blocks.

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

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). 61 words, ~495 tokens.

Download SKILL.mdSave it as .claude/skills/game-world-design/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
game-world-design
description
Design game experience, systems, and levels. Converge the chosen concept into one GAME_DESIGN defining the player promise, core loop, how the world responds, the systems actually needed, level pacing, feedback, failure, and a fully playable prototype. Use for design the game world, deepen the gameplay and levels, write the game design document, design the branching story structure, scenes, dialogue and consequences. 游戏体验、系统与关卡策划。把选定概念收束为一份 GAME_DESIGN,定义玩家承诺、核心循环、世界响应、必要系统、关卡节奏、反馈、失败和可完整游玩的原型。用于设计游戏世界、深化玩法和关卡、设计互动叙事的场景对白与分支因果等需求。

游戏体验与世界设计

把选定概念变成可实现的玩家体验,不写世界观百科、工程方案或美术方向。

输入必须包含 SOURCE_BIBLE.md、已选择的 CONCEPT.md 和 PRODUCT_BRIEF.md。读取 world-design-method.md;确有资源、门槛或难度时再读 numeric-design-method.md。

叙事实际承载体验时读取 narrative-design-method.md, 不为所有项目强制写长篇对白。

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

设计原则

  • 保护 CONCEPT 的玩家承诺、experienceProfile 和不可妥协项;发现范围冲突时回上游修订。
  • 切片时长与系统范围服从 brief,以暴露最大设计风险为准,不预设时长或系统数量。
  • 不写文件名、函数、存储键、测试脚本、着色器或资产管线;实现结构由构建阶段决定。

输出合同

生成一个 design/GAME_DESIGN.md,保持紧凑并包含:

  1. 体验与循环合同:玩家身份、承诺、目标感受、experienceProfile、核心动作与循环和主要玩法先例, 以及原作如何改变动作对象、顺序、代价和世界回应;
  2. 世界规则与进程:玩家可见/隐藏信息、行动顺序、随机性、资源或持久状态及其读取点; 适合本项目的局面、能力或理解变化,以及可观察结束标记,不强套成长阶段;
  3. 决策与关卡节拍:关键局面如何要求玩家行动或取舍,玩家拥有何种因果权与结算权;
  4. 反馈、失败与重开:输入反馈、状态变化、失败原因、下次可改之处和定义初态;
  5. 叙事附件:仅在叙事实际承载体验时写场景脊柱、人物议程、知识/证词边界、持久回响、 分支汇流和结局回收;否则写 N/A;
  6. 语言、文化与交接边界:界面语言、术语、阅读顺序、内容尺度,以及交给美术和构建的玩家效果;
  7. 可执行切片合同:最大设计风险、匹配的原型形态、最小状态、动作前置/效果,以及初态、输入路径、 预期状态与反馈;随机性相关时固定 seed,知情差或事件回读相关时才补观察者与事件;若概念选择了 signature_command,按方法「身份专属命令与延期回响」补齐结构;
  8. 验证切片:范围、明确非目标、完整路径和会触发设计修改的观察结果。

规则优先用短表表达,不复制成平行 JSON、go/no-go 表或第二份验收矩阵。

完成检查

按 world-design-method 反向走读可执行闭环、世界回响、设计进程、重放与范围;存在叙事或专属命令时, 再按对应方法检查知识、分支、人物行动、解析候选与实际执行没有串线。只交付设计合同,不替实现选技术, 也不把趣味或平衡写成确定性 PASS。

输出交回总入口,不自行推进美术、构建或 QA。

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

  • SKILL.md
  • agents/openai.yaml
  • references/narrative-design-method.md
  • references/numeric-design-method.md
  • references/world-design-method.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 World 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 World Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Game World Design this skillzenstory-ai/novel-to-game841—~495Automated safety check: PassMIT
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
Game Asset Spec WriterDonchitos/Claude-Code-Game-Studios26k—~5kAutomated safety check: PassMIT
Game Experience Density OptimizerDY-2026/GameDesignOS415—~2.1kAutomated safety check: PassMIT
Threejs Gameplay Systemscorosolto/client257—~1.5kAutomated safety check: PassAGPL-3.0

Similar skills

  • 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
  • Game Asset Spec Writer

    Donchitos/Claude-Code-Game-Studios

    Writes per-asset visual specs and AI image-generation prompts for a game's characters, enemies and screens, driven by the GDD, art bible and an entity inventory.

    26k GitHub stars~5k tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • 当用户需要把游戏体验浓度、留存、首局节奏、Demo 完成率、单机总旅程、D1/D7、反馈、具身感、氛围、认知负荷、最佳刺激窗口、FEP/free-energy、预测误差、Markov blanket、习惯化或 liveops 参与问题,编译成可上线、可埋点、可复盘、可回滚的一周 ED 实验包时使用。Use when converting game experience-density and…

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

More from zenstory-ai/novel-to-game

  • Game Build From Design

    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.

    841 GitHub stars~661 tokensUpdated 8 days ago
    Auto-check passed
  • 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

Questions about Game World Design

What does Game World Design do?

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. md` that turns the concept into a player experience a team can build. It deliberately avoids world-lore encyclopedias, engineering plans, art direction, file names, functions, shaders and asset pipelines.

When should I use Game World Design?

Game World Design fits situations like: turning a selected game concept into a design document with a core loop and level pacing; designing how the game world responds to player actions and what happens on failure; planning branching scenes, dialogue and consequences when story drives the gameplay; defining a playable prototype slice and what it should validate.

How do I install Game World Design in Claude Code?

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

How do I install Game World Design in Codex?

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

Can I use Game World 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-world-design -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-world-design, .gemini/skills/game-world-design, .github/skills/game-world-design and .opencode/skills/game-world-design in your project.

What does Game World Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Game World Design is instructions for the agent only. Our summary lists: SOURCE_BIBLE.md, CONCEPT.md and PRODUCT_BRIEF.md from earlier project stages.

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

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

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

What are the alternatives to Game World Design?

Skills that share tags, products or a category with Game World Design: Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars), Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars), Game Asset Spec Writer (Donchitos/Claude-Code-Game-Studios, 26k stars) and Game Experience Density Optimizer (DY-2026/GameDesignOS, 415 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Game World 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.