Lemo-Opuscar

The styles, guides and tools ship with this plugin, in library/ next to this file. Nothing is downloaded to tell you what to do.

Get the library ready. Run sh "<skill base directory>/scripts/setup.sh". It copies the bundled library to its working folder (default ~/.lemo-opuscar, so installed packages survive plugin updates) and prints LIB=<path> on its last line.
Install the core tools early. Start sh "<skill base directory>/scripts/setup.sh" deps right away, in the background if you can: it takes a few minutes the first time. Add deps voice or deps music later, only if the film needs them ($LIB/TECHNIQUE.md §1). Report missing system tools (Node, ffmpeg, Python) in your one round of questions; don't install system software yourself. Packages a style needs (its STYLE.md lists them) you install yourself, into the project folder.
Follow the library. Read $LIB/AGENTS.md and do what it says: finding the style, the one round of questions, the treatment, production and delivery.

What changes in skill mode:


Project folder	`<name>/` in the folder the user started from (lowercase letters, digits, hyphens; avoid `#` and `?` in the path). Wherever the guides say `films/<name>/`, read this folder
Running tools	from `$LIB`, with the project's absolute path: `cd "$LIB" && node core/render/still.mjs "<project>" 1.5 3`. `sh tools/setup.sh` and `sh tools/fetch.sh` also run from `$LIB`
Library files in pages	absolute URLs: `/core/lib.js`, `/node_modules/three/…` (the project is served at `/@film/`)
Library files in scripts and `build.sh`	`$LIB/…`, with `LIB=<path>` at the top of `build.sh`; never `../..`
Demo films	not in this edition: no `demo/` source and no `poster.jpg`. Each style's `DEMO.md` (how its demo was made) is there; read it only after your `TREATMENT.md` is written, as the guides say. The films are on the gallery, https://lemomo-ai.github.io/lemo-opuscar/, if the user wants to watch one
Chinese narration	Kokoro's Chinese voices (offline) by default. edge-tts (`core/tts/tts_zh.py`) sounds better but sends the narration text to Microsoft's speech service: offer it in your one round of questions and use it only if the user agrees
Big downloads	only what the film needs, from the sources `$LIB/TECHNIQUE.md` §1 lists (npm, PyPI, Playwright's browser, this library's GitHub Releases, Hugging Face for the speech check). Name them in your one round of questions the first time

Deliver what $LIB/DIRECTOR.md §11 lists, in the project folder, and tell the user where it is.

lemo-opuscar