the signals and their derived score are provisional and subject to change.
validate manually before sharing.
cc4f56cb84e84d831cd4f234b77d38d72b9e947d6352617884081 month agoCo-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>64f25b96f6671 month agoCo-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>27ae6f3a6acb1 month agoCo-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>724f12d837272 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>482761ea21092 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>146519beace82 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>b52929240d0d2 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>0d41c888c5302 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>3463f1d151a72 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>bc4ec435f2792 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>4d8de21e2f422 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>15ab1f9aae592 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>5f7e0b6424002 months agoCo-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>92c40cacd3616 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3fabbd3dfbf16 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>ce975927e38d6 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>1604cf1848496 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>20f70cc9b40a6 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>929b62707fd06 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>c407ae8bdf086 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>b2ea9de9e1c46 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>55edc34f8a046 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>5573056916b86 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3b2abde4e38e6 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>ae22943f6dcc6 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>7b83ba820bd07 months agoCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>edd3d7a0c45f7 months agoCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>38cfaffa22a37 months agoCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>48a81d7bd6107 months agoCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>d0300a20a0ef7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3cb2019a85db7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>a0e20548d2b57 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>d0562e0d5f477 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>582002f02b6a7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>b601f7c77e087 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>d3f313df2a4a7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>365cc7fb40057 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3ac7f5d830477 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3549066e49af7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>652b5ffd19a67 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>c2ecf3dd69127 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>02c3041a69897 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3ec8844163ea7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>adf1a0b2f2657 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>e799b03396ac7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>c52089c7a8b87 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>695b25994a7e7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>5819153c2bdd7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>cace74e1124e7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>878cf442f8fe7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>b98352185d607 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>a27900fb1e587 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>46f2975da2c07 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>11070a39abdb7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>38a6f76e76c67 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>08ecc6f4d0917 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>d6a2c7112a368 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>2753f546ae1e8 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>494a833ed93d8 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>fe003535375f10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>fbb2d86f5a1c10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>bdf37d605d6710 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>0d0708a502da10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>371451cc3fc210 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3518e365631b10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3e839928f6ae10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>6edbecc5e73310 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>3f03fb36244410 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>be6255d8f91610 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>e1abe77b7e1c10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>dc506530580510 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>218e4ec8e08e10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>66cd20510cc510 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>d326108f90dc10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>81d1548b49e110 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>494ace8bacca10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>23327ea3f98010 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>93e9dde9d0f210 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>620b2f21d67210 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>0836ace7cc3810 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>d26d943cf0c210 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>9925faf5cbe810 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>26e1ac767b4e10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>77e9998ea06b10 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>c4e65b71556010 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>---
name: pixi-vn-migration
description: Use when upgrading an existing @drincs/pixi-vn project to a newer version, or when a runtime/type error matches a known breaking change. Covers every breaking change between versions with before/after code.
---
# Pixi'VN Migration guide
Official docs: [pixi-vn.com/faq/migration](https://pixi-vn.com/faq/migration). That page also covers
the separate `nqtr` and `pixi-vn-ink` packages — this skill only covers the core `@drincs/pixi-vn`
package (the `## pixi-vn` sect---
name: pixi-vn-saves
description: Use when implementing save/load in a Pixi'VN game — Game.exportGameState()/restoreGameState()/jsonToGameState(), what the exported GameState contains, and how to persist it (save slots, quick-save, auto-save-on-refresh, downloadable JSON). Load this before writing any save-file, save-slot, or "continue game" feature.
---
# Pixi'VN Saves: exporting, restoring, and persisting game state
Official docs: [pixi-vn.com/start/save](https://pixi-vn.com/start/save).
## When t---
name: pixi-vn-testing
description: Use when an AI agent (or any external script) needs to play-test a running Pixi'VN game end-to-end in a real browser — starting the game, advancing/branching the story, answering input prompts, going back, and reading/writing storage — via `Game.testing`, the opt-in devtools bridge exposed on `window`. Load this before wiring up automated/agent-driven playtesting, not for authoring story content itself (see `pixi-vn-narration`).
---
# Pixi'VN Testing module
## Wh---
name: pixi-vn-canvas
description: Use when adding, moving, or removing images, sprites, spritesheet frame animations (AnimatedSprite), text, or video on the Pixi'VN game canvas, or when applying or creating transitions (dissolve, fade, move, zoom, push, wipe, iris, split, flash, blur, pixelate, or a custom one built on `canvas.animate`/`filters.animate`), shake/animation effects, or ticker-based animations built on PixiJS. Covers the `canvas` singleton exported from `@drincs/pixi-vn`. For UI layers (HTM---
name: pixi-vn-characters
description: Use when defining visual novel characters for a @drincs/pixi-vn game — creating a character with a name, color, icon and other props, registering it so it can be looked up by id, and referencing it from dialogue/narration. Load this before writing any `CharacterBaseModel` or `RegisteredCharacters` code.
---
# Pixi'VN Characters
## When to use this skill
Use this skill whenever a task involves creating the characters that appear in a
Pixi'VN game (name, surname,---
name: pixi-vn
description: Index and entry point of the Pixi'VN skill set — start here for any task on a @drincs/pixi-vn project, then follow the skill map to the right skill (narration, canvas, characters, assets, sound, storage, saves, history, ui, minigames, testing, migration). Use when setting up a new or existing project, wiring the main.ts entry point, or calling the top-level Game API (Game.init, Game.start, Game.onEnd, Game.addOnError, Game.onNavigate, Game.clear) — every Pixi'VN project ne---
name: pixi-vn-minigames
description: Use when adding a minigame (snake, quiz, puzzle, timing/reaction game, ...) to a Pixi'VN visual novel — the `useMinigame` lifecycle hook pattern, using PixiJS directly on its own layer instead of `gameLayer`, hotkeys for controls, linking the minigame to a route, and why saving/restoring minigame state is the developer's own responsibility.
---
# Pixi'VN Minigames
Official docs: [pixi-vn.com/start/minigames](https://pixi-vn.com/start/minigames).
Pixi'VN has no d---
name: pixi-vn-narration
description: Use when writing or editing Pixi'VN story content — defining labels (scenes) with newLabel, writing dialogue steps, adding player choices with newChoiceOption/newCloseChoiceOption, conditional/branching labels, or wiring up narration.call/jump/continue and Game.start to progress the story.
---
# Pixi'VN Narration module
## When to use this skill
Use this skill whenever the task is about the story itself: creating a new scene/label, writing a
line of dialogue, ad---
name: pixi-vn-history
description: Use when implementing "go back" / "rewind" / step-navigation features in a Pixi'VN game, or when you need to read the player-facing dialogue/choice history (e.g. for a backlog or "history log" UI) — covers the History module's `stepHistory` API and the "step" vs "paragraph" goBackMode.
---
# Pixi'VN History module
> Official docs: https://pixi-vn.com/start/history — this skill also documents `goBackMode` and the
> real-world go-back/backlog patterns not detailed ---
name: pixi-vn-sound
description: Use when playing or stopping background music, sound effects, or voice lines; creating/organizing audio channels; controlling volume, mute, or pan; or wiring Tone.js audio filters (reverb, delay, EQ, etc.) in a Pixi'VN game.
---
# Pixi'VN sound: channels, playback, volume, and filters
Official docs: [pixi-vn.com/start/sound](https://pixi-vn.com/start/sound). The sound module is a wrapper around [Tone.js](https://tonejs.github.io/examples/); the whole audio system was r---
name: pixi-vn-storage
description: Use when reading or writing persistent game variables in a @drincs/pixi-vn game — simple flags/counters via `storage`, custom persisted classes via `StoredClassModel`, temporary (label-scoped) variables, and how any of this survives save/load and history go-back. Load this before writing any `storage.set`/`storage.get`/`storage.flags.set` code or a class that extends `StoredClassModel`.
---
# Pixi'VN Storage
## When to use this skill
Use this skill whenever a task---
name: pixi-vn-assets
description: Use when adding, organizing, registering, or loading non-code files (images, audio, video) in a Pixi'VN project — local assets processed by PixiJS AssetPack vs. online/remote-hosted assets, the AssetsManifest/bundle/alias system, where to edit the manifest for each case, and when to load bundles (at startup, in the background, per-label, per-route). Load this before writing any code that references an image/sound/video path directly, or before adding entries to a mani---
name: pixi-vn-ui
description: Use when building game UI (menus, HUD, dialogue box, settings/save screens) on top of Pixi'VN with an external JS framework (React, Vue) or with plain PixiJS components — mounting HTML or PixiJS UI layers over the canvas, navigating between UI screens/routes, theming a shadcn/ui-based template, and connecting UI components to game storage/settings. Covers `canvas.htmlLayers.add`/`get`/`remove` and the PixiJS-only layer helpers `canvas.layers.add`/`get`/`remove`.
---
# Pi# Developing Pixi'VN
This file is for anyone (human or AI agent) making changes to the `@drincs/pixi-vn` library itself —
not for a project that merely *uses* the library (that's what the `skills/` directory and
[pixi-vn.com](https://pixi-vn.com) are for).
## 1. The library must stay modular and generic
Pixi'VN is a general-purpose engine, not a specific game. Every module under `src/` (`canvas`,
`narration`, `sound`, `storage`, `history`, `characters`, `worker`, ...) must keep working:
- **Independennone