Interactive Film Authoring
Narcooo/inkos
Method for writing interactive film and game scripts with branching story trees, state variables, producible nodes, multiple endings and consistent assets.
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.
SKILL.md written in Chinese; this summary is our English description.
Install Novel Game Adaptation Analysis
$ npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install zenstory-ai/novel-to-game novel-game-analyze --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-game-analyze .claude/skills/novel-game-analyze && rm -rf skills-srcUse ~/.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/
Install the "novel-game-analyze" agent skill from https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyze into .claude/skills/novel-game-analyze/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "novel-game-analyze", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyzeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install zenstory-ai/novel-to-game novel-game-analyze --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zenstory-ai/novel-to-game.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/novel-game-analyze .agents/skills/novel-game-analyze && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "novel-game-analyze" agent skill from https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyze into .agents/skills/novel-game-analyze/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "novel-game-analyze", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install zenstory-ai/novel-to-game novel-game-analyze --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zenstory-ai/novel-to-game.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/novel-game-analyze .cursor/skills/novel-game-analyze && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "novel-game-analyze" agent skill from https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyze into .cursor/skills/novel-game-analyze/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "novel-game-analyze", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/zenstory-ai/novel-to-game.git --path skills/novel-game-analyze--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install zenstory-ai/novel-to-game novel-game-analyze --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zenstory-ai/novel-to-game.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/novel-game-analyze .gemini/skills/novel-game-analyze && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "novel-game-analyze" agent skill from https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyze into .gemini/skills/novel-game-analyze/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "novel-game-analyze", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install zenstory-ai/novel-to-game novel-game-analyzeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/zenstory-ai/novel-to-game.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/novel-game-analyze .github/skills/novel-game-analyze && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "novel-game-analyze" agent skill from https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyze into .github/skills/novel-game-analyze/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "novel-game-analyze", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install zenstory-ai/novel-to-game novel-game-analyze --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zenstory-ai/novel-to-game.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/novel-game-analyze .opencode/skills/novel-game-analyze && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "novel-game-analyze" agent skill from https://github.com/zenstory-ai/novel-to-game/tree/main/skills/novel-game-analyze into .opencode/skills/novel-game-analyze/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "novel-game-analyze", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
novel-game-analyze- GitHub stars
- 841
- Token cost
- ~558 tokens
- SKILL.md length
- 71 words
- Files
- 3 (incl. references)
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- MIT
At a glance
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.
- Analyzing a novel to see what it offers for a game adaptation
- SKILL.md covers 输入, 全书管道, 提取维度 and 输出
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Pulling world rules, player verbs and systems from a book with cited evidence
What it does
This skill reads a novel, a deconstruction library or a writing project and boils it down to a fact layer that game designers can build on. It does not judge the prose and does not pick a game genre. Instead it records the world's rules, the verbs a player could perform, spaces, what characters want, candidate systems and visual anchors, with chapter or file locations attached to hard rules, key character goals and turning points.
The work follows a fixed pipeline: set the boundaries, extract unit by unit, check coverage, aggregate in layers, verify against the source text, then compress for delivery, with details in a bundled gameability-protocol.md reference. Existing full-book analysis is reused where possible, and a partial preview of the opening chapters is not accepted as proof that the whole book was understood. The result is analysis/SOURCE_BIBLE.md, with a coverage table, an adaptation-boundary table, a glossary, risks and design gaps. Quotes stay in the source language, and output language follows PRODUCT_BRIEF.md or the conversation.
When your agent uses it
- Analyzing a novel to see what it offers for a game adaptation
- Pulling world rules, player verbs and systems from a book with cited evidence
- Condensing a deconstruction library or writing project into a source bible
- Building the fact base before choosing a game genre for a story
Example prompts
- “Analyze the novel in ./books/river-lanterns.txt for game adaptation and write analysis/SOURCE_BIBLE.md.”
- “I already have a full deconstruction of this web novel in ./analysis, so condense it into a source bible with chapter-cited evidence.”
- “游戏化拆书：把 ./novel/ 里的全部章节整理成带原文证据的 SOURCE_BIBLE。”
Requirements
- The novel text, deconstruction library or writing project to analyze
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 Game Adaptation Analysis loads about 558 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 127 tokens; SKILL.md has 71 words of instructions outside code blocks.
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). 71 words, ~558 tokens.
Download SKILL.mdSave it as
.claude/skills/novel-game-analyze/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- novel-game-analyze
- description
- Deconstruct a novel for game adaptation. Compress a raw novel, deconstruction library, or writing project into a SOURCE_BIBLE with cited textual evidence, extracting world rules, player verbs, spaces, character will, systems, and visual anchors — without inventing a genre yet. Use for gameable book analysis, analyze a novel for game adaptation, extract game systems from a book. 游戏化拆书。把原始小说、拆文库或写作工程压缩成有必要原文证据的 SOURCE_BIBLE，提取世界规则、玩家动词、空间、角色意志、系统和视觉锚点，不提前发明游戏类型。用于游戏化拆书、分析小说的游戏改编基础等需求。
小说游戏化拆解
建立游戏设计所需的事实层，不评价文笔，也不在此阶段选择游戏类型。
产物语言由 PRODUCT_BRIEF.md 锁定；未锁定时跟随对话语言，不默认产出中文。
原文可以是任意语言。引用保留原文；策划语言或界面语言与原文不同时附必要译文，并建立角色名、 地名、物件和规则的统一术语表；礼制、宗教和叙事惯例不替换成另一文化的近似类型标签。
输入
优先复用现有写作工程或全量拆文产物，只回原文补关键证据；只有原始小说时才执行 本 skill 的全书管道。已有分析若只覆盖黄金三章或快速预览，只能帮助判断开篇，不能 证明理解了全书。除非用户明确只改编某一卷或片段，否则来源未覆盖全文时不得进入概念设计。
若存在 PRODUCT_BRIEF.md，先读取：分级、核心幻想与已锁类型决定取证优先级——优先为
核心幻想涉及的动作、关系、场面取证；对已锁类型需要而原作未系统提供的体系（如属性相克、
数值成长），在设计空白中写明「原作无系统化的对应体系，属下游发明」，供下游改编边界如实
引用。
全书管道
建立边界 → 逐单元提取 → 覆盖门禁 → 分层聚合 → 回查原文 → 压缩交付。各步做法以 gameability-protocol.md 为准，此处只列顺序，不重述。选定改编段落的核对在概念选定后二次 进入时做，产出逐事实表（见「输出」）。工作卡只服务覆盖、恢复和复核，不把过程日志包装成策划成果。
可以在运行时并行处理互不重叠的章节批次，但每批必须使用同一提取契约，聚合和事实回查 保持串行。环境不支持并行时逐批串行完成，不能改成抽样。
提取维度
只保留会影响玩家动作、世界响应或视听身份的内容；维度、覆盖状态与命令/委托的记录方式以协议 「逐单元取证」「从事实得到系统候选」为准。
为硬规则、关键角色目标、玩家身份依据、转折结局和标志性锚点记录章节或文件位置。 普通候选项不必机械附带置信度对象；推断必须明确标成推断或开放设计空间。
输出
生成一份 analysis/SOURCE_BIBLE.md，包含来源范围、全书覆盖、世界身份、原作事实与
证据、改编边界、玩家身份候选（PRODUCT_BRIEF 已锁身份时改为该身份的动作空间验证）、
可玩动词、可下达/承接的身份动作及其执行阻力、世界模型、空间与角色能动性、文化语境、
术语表（语言条件见上）、视觉锚点、风险和设计空白。全书覆盖按连续范围列出开篇、中段、结局和跨段
回收的关键变化、强弱节奏、反例与游戏化意义；表头写明来源单元数与成功数，覆盖集合必须与来源单元
集合一致。短表格优先于重复文档、结构化数据和证据索引。
改编边界必须是表格：条目 | 边界类型 | 证据位置，边界类型只用协议的四种标签；涉及
名分、座次、官阶或队伍序列的作品必须附人物名册行（姓名 | 身份/次序 | 结局 | 证据回目），
作为下游各交接门逐项比对的名册基准。
概念阶段选定改编段落后，二次进入本 skill 为该段落补一张逐事实表并追加进 SOURCE_BIBLE：
事实 | 证据位置 | 边界类型，含入镜角色的外观要点（服饰、兵器、体量及位置；原文无描写
写「原文未明确」）。此表是下游交接门的段落级比对基准；下游仍可回原文补证，发现出入时
回上游修正此表，不得各自改写。概念选定后只补充或纠正有依据的原作事实——SOURCE_BIBLE
不得包含下游发明物，游戏状态键名、回合或日程编号、
scene_id、Hub/界面结构、QA 与范围计划只属于 GAME_DESIGN，不得把既有事实改写成
切片说辞。
来源范围只记录会影响复核的版本、覆盖范围和授权边界。下载日期、字节数、校验值和 本地路径只有在复现契约确实需要时才写，不把获取日志当策划内容。
其余完成门禁见协议「事实保真与交付」。
© 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 2 other files (references) in skills/novel-game-analyze of zenstory-ai/novel-to-game.
- SKILL.md
- agents/openai.yaml
- references/gameability-protocol.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 Game Adaptation Analysis 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Novel Game Adaptation Analysis this skillzenstory-ai/novel-to-game | 841 | — | ~558 | Automated safety check: Pass | MIT | |
| Interactive Film AuthoringNarcooo/inkos | 10k | — | ~774 | Automated safety check: Pass | AGPL-3.0 | |
| InkOS Interactive World PlayNarcooo/inkos | 10k | — | ~793 | Automated safety check: Pass | AGPL-3.0 | |
| Game Designericrisco/rsc-harness | 180 | — | ~3.6k | Automated safety check: Pass | MIT | |
| Threejs Gameplay Systemsvalkor-ai/loom | 1.2k | 1 repos | ~1.4k | Automated safety check: Pass | Apache-2.0 | |
| Godot Gdscript Patterns925236118/AlphaAgent | 103 | 10 repos | ~5k | Automated safety check: Pass | MIT |
Similar skills
InkOS Interactive World Play
Narcooo/inkos
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.
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…
Threejs Gameplay Systems
valkor-ai/loom
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…
Godot Gdscript Patterns
925236118/AlphaAgent
Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.
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.
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.
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.
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.
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.
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.
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.
Related
Categories
Questions about Novel Game Adaptation Analysis
What does Novel Game Adaptation Analysis do?
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. This skill reads a novel, a deconstruction library or a writing project and boils it down to a fact layer that game designers can build on. It does not judge the prose and does not pick a game genre.
When should I use Novel Game Adaptation Analysis?
Novel Game Adaptation Analysis fits situations like: analyzing a novel to see what it offers for a game adaptation; pulling world rules, player verbs and systems from a book with cited evidence; condensing a deconstruction library or writing project into a source bible; building the fact base before choosing a game genre for a story.
How do I install Novel Game Adaptation Analysis in Claude Code?
Run `npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a claude-code`. Or copy the skill folder (skills/novel-game-analyze in zenstory-ai/novel-to-game) into .claude/skills/novel-game-analyze in your project. Claude Code loads it when a task matches its description.
How do I install Novel Game Adaptation Analysis in Codex?
Run `npx skills add zenstory-ai/novel-to-game --skill novel-game-analyze -a codex`. Or copy the skill folder (skills/novel-game-analyze in zenstory-ai/novel-to-game) into .agents/skills/novel-game-analyze in your project. Codex loads it when a task matches its description.
Can I use Novel Game Adaptation Analysis 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-game-analyze -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-game-analyze, .gemini/skills/novel-game-analyze, .github/skills/novel-game-analyze and .opencode/skills/novel-game-analyze in your project.
What does Novel Game Adaptation Analysis need to run?
SKILL.md names no scripts, command-line tools or credentials: Novel Game Adaptation Analysis is instructions for the agent only. Our summary lists: The novel text, deconstruction library or writing project to analyze.
Does Novel Game Adaptation Analysis 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 Game Adaptation Analysis 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 Game Adaptation Analysis use?
Novel Game Adaptation Analysis 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 Game Adaptation Analysis use?
About 558 tokens (SKILL.md is roughly 2.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 1k tokens, read only when the agent opens those files.
What are the alternatives to Novel Game Adaptation Analysis?
Skills that share tags, products or a category with Novel Game Adaptation Analysis: Interactive Film Authoring (Narcooo/inkos, 10k stars), InkOS Interactive World Play (Narcooo/inkos, 10k stars), Game Design (ericrisco/rsc-harness, 180 stars) and Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Novel Game Adaptation Analysis?
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.