Skip to content
SkillModel-led1,793 tokens in use

visual-novel

Builds visual novels and choice-driven stories in Ren'Py or any engine: routes, endings, saves, backlog and skip, with reachability checks.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/genres/visual-novel
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing visual-novel costs

91tokens idle
1,793tokens in use
3,131tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure25/25
  • Examples12/15
  • Output10/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

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.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers