This skill covers the shape of a branching story and the reading conveniences players expect from a visual novel. The script runtime (Ren’Py, Ink or Yarn Spinner) steps through the text; the skill decides routes, flags, affection thresholds, save behaviour and reader-facing systems, then checks them.
It includes a route-map method, script sizing from reading speed, a table of defaults for text speed, skip, auto-forward, backlog, saves and galleries, a typewriter reveal pattern, and a list of gotchas such as loads that resume at the wrong line and unreachable endings.
What You Get
- A workflow from route map and script sizing to state tracking and save design
- A table of reader-system defaults for text speed, skip, auto-forward, backlog, saves and galleries
- A typewriter reveal pattern that does not make words jump between lines
- Verification steps for Ren’Py lint and tests, an Ink compile and branch walk, and save-and-load checks
Common Use Cases
- Planning routes, lock-in points and endings for a dating sim or story game
- Fixing a load that resumes at the start of a scene or skip that runs through unread text
- Checking that every planned ending can be reached from the choices
- Adding save slots, backlog and auto-forward to a custom engine
What Makes It Unique
The skill pairs story design with checks the agent can run: Ren’Py lint with an error exit code, an Ink compile followed by a breadth-first walk that collects ending tags, and a save-quit-load test. It separates what Ren’Py already provides from what must be built in other engines, and defers Ink and Yarn integration code to the dialogue-systems skill.
Under The Hood
The agent loads the SKILL.md and, when needed, a reference on script data models, route structure, save data and localisation. It has no scripts of its own. The verification step tells the agent to run commands in your project: the Ren’Py launcher for lint and tests, the Ink compiler, and a small branch-walking script using the inkjs library, plus a manual save, quit and load check. Those runs read your story files and may write compiled story output.