Agent skill

Novel to Game

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

MITAuto-check passedGame Development

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

Install Novel to Game

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

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

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

At a glance

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

  • Works in 8 steps: 建立工作区,记录来源、模式、当前阶段和未确认假设。 → 生成 PRODUCT_BRIEF.md;高风险歧义未解决时才停靠。 → 调用 novel-game-analyze 生成有原文依据的… → …
  • Adapting a novel or book into a playable game prototype
  • SKILL.md covers 默认策略, 模式, 流程 and 语言与文化, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This is the entry point for a family of skills that adapt a novel into a game on a chosen target platform. It acts as a director: it drafts PRODUCT_BRIEF.md from the source, asks about ambiguities only when they change direction or raise rights, content-rating or platform risks, and lists lower-risk gaps as unconfirmed assumptions instead of stopping on each one. Three modes exist: quick (the default), director (pauses so you can pick a direction) and resume (continues from _progress.md).

The pipeline calls novel-game-analyze for a source-grounded SOURCE_BIBLE.md, game-concept for CONCEPT.md, game-world-design for GAME_DESIGN.md, game-art-direction for ART_DIRECTION.md, and game-build and game-qa for the build and the minimum QA checks. A white-box candidate is built against the biggest design risk before full art production, and problems go back to the product, design, art or build owner.

Plot has to become player verbs, choices and world feedback rather than a chapter-by-chapter replay, and replayable rules, not a generative model, decide state changes, resource settlement and irreversible commitments. Output follows the language you name or the chat language, with source evidence kept in its original language. The SKILL.md is written mainly in Chinese.

When your agent uses it

  • Adapting a novel or book into a playable game prototype
  • Making an interactive story or text adventure from a novel
  • Resuming a half-finished novel-to-game adaptation from its progress file

Example prompts

  • “Turn the novel in ./books/lighthouse.txt into a playable text adventure.”
  • “Use director mode to adapt this book into a game and let me pick the concept.”
  • “Resume the novel to game project from _progress.md.”

Workflow steps

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

  1. 建立工作区,记录来源、模式、当前阶段和未确认假设。
  2. 生成 PRODUCT_BRIEF.md;高风险歧义未解决时才停靠。
  3. 调用 novel-game-analyze 生成有原文依据的 SOURCE_BIBLE.md。
  4. 调用 game-concept 比较仍开放的方向并选定 CONCEPT.md;自然语言专属命令按玩法需要选择,
  5. 调用 game-world-design 生成 GAME_DESIGN.md,其中锁定最大设计风险与最小可执行切片。
  6. 在完整美术生产前调用 game-build 做与最大风险匹配的白盒候选;试玩后把偏差交回 design owner
  7. 调用 game-art-direction 生成 ART_DIRECTION.md;只有目标成色需要时再制作视觉目标包。
  8. 再由 game-build 将验证后的因果语义实现为完整候选,game-qa 验证最小闭环;问题按

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

Novel to Game loads about 567 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 158 tokens; SKILL.md has 85 words of instructions outside code blocks.

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

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). 85 words, ~567 tokens.

Download SKILL.mdSave it as .claude/skills/novel-to-game/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
novel-to-game
description
Turn a novel into a fully playable game on the selected target platform. Orchestrates the whole adaptation pipeline — requirements intake, gameable deconstruction, concept selection, world and visual design, target-runtime build, and evidence-based QA — for a novel in any language. Use for novel to game, story to game, book to game, adapt this novel into a game, turn this book into a playable prototype, make an interactive story or text adventure from this novel. NovelToGame 总入口。把任意语言的原始小说、拆文库或 oh-story 写作工程转成有原著依据、可在目标平台完整游玩的游戏,编排游戏化拆解、概念选择、游戏与视觉设计、目标运行环境构建和证据化质量验证。用于小说转游戏、把这本书做成游戏、把小说改成互动小说 / 互动叙事 / 文字冒险游戏等需求。

NovelToGame 总入口

你是小说游戏化总导演:守住改编判断、阶段边界和完成证据,不把普通原型包装成趣味、平衡、权利或 发布质量结论。开始前读取 pipeline-contract.md。

默认策略

先速读来源并替用户起草 PRODUCT_BRIEF.md,再按 intake-method.md 只处理会实质改变方向或带来权利、尺度、平台风险的 歧义。低风险空白集中列为未确认假设,不逐项拦停。

targetFinish 只表示想做到的成色:graybox、playable-prototype、polished-vertical-slice 或 showcase,不改变六项最小 QA,也不形成第二套验收等级。

PRODUCT_BRIEF.md 与 SOURCE_BIBLE.md 是上游事实,下游不得静默改写。

模式

  • quick:默认;用推荐草案推进,比较有效替代后自动选择并完成全流程。
  • director:给出候选和推荐后停靠,等待用户选方向;已有明确选择时不重复停靠。
  • resume:读取 _progress.md 和实际产物,从最早未完成的交接继续。

流程

  1. 建立工作区,记录来源、模式、当前阶段和未确认假设。
  2. 生成 PRODUCT_BRIEF.md;高风险歧义未解决时才停靠。
  3. 调用 novel-game-analyze 生成有原文依据的 SOURCE_BIBLE.md。
  4. 调用 game-concept 比较仍开放的方向并选定 CONCEPT.md;自然语言专属命令按玩法需要选择, 不适用时明确 N/A;director 的待决方向在此停靠。
  5. 调用 game-world-design 生成 GAME_DESIGN.md,其中锁定最大设计风险与最小可执行切片。
  6. 在完整美术生产前调用 game-build 做与最大风险匹配的白盒候选;试玩后把偏差交回 design owner 局部修订并重放受影响路径,不能用文本模拟结果冒充空间或操作验证。
  7. 调用 game-art-direction 生成 ART_DIRECTION.md;只有目标成色需要时再制作视觉目标包。
  8. 再由 game-build 将验证后的因果语义实现为完整候选,game-qa 验证最小闭环;问题按 product/design/art/build 归属回流,不让实现阶段静默重做策划。

语言与文化

接受任意语言小说。产物使用用户指定语言,未指定时跟随对话语言;原文证据保留原语言,跨语言只补 决策所需译文并维护一个术语表。原作文化语境、目标市场和界面语言分别记录,不用逐字翻译替代本地化判断。

改编判断

  • 剧情必须转成玩家动词、选择和世界反馈,而非逐章复演。
  • experienceProfile(system-led / narrative-led / hybrid)由 brief 起草、概念阶段确认,之后 贯穿设计、美术、构建与 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 3 other files (references) in skills/novel-to-game of zenstory-ai/novel-to-game.

  • SKILL.md
  • agents/openai.yaml
  • references/intake-method.md
  • references/pipeline-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

Novel to Game 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.

Novel to Game compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel to Game this skillzenstory-ai/novel-to-game841—~567Automated safety check: PassMIT
Game Designericrisco/rsc-harness180—~3.6kAutomated safety check: PassMIT
Interactive Film AuthoringNarcooo/inkos10k—~774Automated safety check: PassAGPL-3.0
InkOS Interactive World PlayNarcooo/inkos10k—~793Automated safety check: PassAGPL-3.0
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
Roblox Gamebrockmartin/roblox-game-skill203—~1.3kAutomated 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
  • Method for writing interactive film and game scripts with branching story trees, state variables, producible nodes, multiple endings and consistent assets.

    10k GitHub stars~774 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Rules for advancing an interactive story or open world in an InkOS Play session: honor the world contract, finish actions, keep state and time consistent.

    10k GitHub stars~793 tokensUpdated yesterday
    Writing & ContentAuto-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
  • 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
  • Co Op Game Intro Generator

    tl2012tl/comfyUI-llama-TE

    For users creating a two-player co-op game menu or opening animation.

    241 GitHub starsUsed in 4 repos~2k tokens
    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
  • 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

Questions about Novel to Game

What does Novel to Game do?

Orchestrates turning a novel in any language into a playable game, from requirements intake and source-grounded analysis through design, build and QA. This is the entry point for a family of skills that adapt a novel into a game on a chosen target platform.md from the source, asks about ambiguities only when they change direction or raise rights, content-rating or platform risks, and lists lower-risk gaps as unconfirmed assumptions instead of stopping on each one.

When should I use Novel to Game?

Novel to Game fits situations like: adapting a novel or book into a playable game prototype; making an interactive story or text adventure from a novel; resuming a half-finished novel-to-game adaptation from its progress file.

How do I install Novel to Game in Claude Code?

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

How do I install Novel to Game in Codex?

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

Can I use Novel to Game 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 novel-to-game -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/novel-to-game, .gemini/skills/novel-to-game, .github/skills/novel-to-game and .opencode/skills/novel-to-game in your project.

What does Novel to Game need to run?

SKILL.md names no scripts, command-line tools or credentials: Novel to Game is instructions for the agent only.

Does Novel to Game 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 Novel to Game 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 Novel to Game use?

Novel to Game 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 Novel to Game use?

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

What are the alternatives to Novel to Game?

Skills that share tags, products or a category with Novel to Game: Game Design (ericrisco/rsc-harness, 180 stars), Interactive Film Authoring (Narcooo/inkos, 10k stars), InkOS Interactive World Play (Narcooo/inkos, 10k stars) and Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel to Game?

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.