shanyin-ai/story-to-game

Story-to-Game is a two-part toolkit for turning written stories into playable interactive narrative games. Both parts work together: an AI skill that converts source material into a structured data file, and a browser-based launcher that runs that file as a clickable game. The first part is the launcher, a single HTML file you open directly in a browser with no server setup needed. You load a JSON script file into it and it plays out as a branch narrative game: you read text, make choices, and follow different story paths. The launcher supports scene and chapter systems, variables and conditional branching, meaning values that track your choices and affect which options appear, multiple ending types, achievement tracking, save and load, and display settings such as dark mode and font size. The second part is the AI skill. Rather than manually writing a JSON game file, you paste a novel, screenplay, or story outline into a compatible AI tool, the README recommends ChatGPT, Claude, or Claude Code, and the skill guides the AI through a multi-step adaptation process: extracting the source text's tone and style, designing branching structures, building a state system with tracked variables, and producing the complete JSON output. A validation script checks 13 criteria before you load the result into the launcher. The toolkit is built around one stated principle: branching should deepen understanding of the original work rather than replace it. Every choice is intended to carry immediate, ongoing, and ending level consequences. The project is written in HTML and licensed under MIT.