# Setup

> Check-only PASS/FAIL report of the animation plugin's prerequisites (ffmpeg, Node, Chromium, numpy, opencv); installs nothing.

- Skill: `melodic-software/setup-58` (Agent Skill)
- Install (CLI): `npx get-skill add melodic-software/setup-58`
- Raw SKILL.md: https://api.skillmd.com/api/skills/melodic-software/setup-58/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: melodic-software (https://skillmd.com/u/melodic-software)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/melodic-software/setup-58

---


## Purpose

This is a **check-only setup** under the plugin contract's carve-out for external prerequisites
setup can only verify (`docs/plugin-philosophy.md`, "Setup is explicit and repeatable"). The
plugin owns no consumer-project configuration; its one `userConfig` option, `playwright_core`, is
set through Claude Code's plugin settings, never written here. Everything else it needs (ffmpeg,
Node, playwright-core and its Chromium) is installed by the operator, and the Python packages are
installed by the plugin's SessionStart hook, so there is nothing an `apply` could conformingly
write.

Non-interactive: never prompt. Run the probe, print the table, stop.

## `check` (read-only)

`${CLAUDE_PLUGIN_ROOT}/scripts/prereq.py` owns every probe, its threshold and its remedy text;
the same rows stop `render.py` and `decode.py` with exit 2 when a tool is missing. Run it, do not
restate it:

```bash
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/pydeps.py run --data-dir "${CLAUDE_PLUGIN_DATA}" -- \
  ${CLAUDE_PLUGIN_ROOT}/scripts/prereq.py --playwright-core '${user_config.playwright_core}'
```

It prints the PASS/FAIL/INFO table with one remediation line per FAIL and exits 1 when any row
fails. An unset `playwright_core` option (empty, or left as the literal placeholder) is skipped;
a set one gets its own row. Report the table as printed. An INFO on numpy or opencv means a
version other than the pin in `${CLAUDE_PLUGIN_ROOT}/requirements.in` is installed: scripts run,
but statistics may differ from the shipped pack and regression, so say so.

When the Python packages are not installed, `pydeps.py run` exits 2 with the repair line instead of
the table: report that line as the one FAIL (the SessionStart hook installs the packages, and a
failed install was reported as a notice at session start), and run
`python3 ${CLAUDE_PLUGIN_ROOT}/scripts/prereq.py` for the tool rows (it needs only the standard
library; numpy and opencv then read FAIL).

Do not install anything, and do not change the `playwright_core` option.

## Next

/animation:rotoscope <clip> <work dir>

## Gotchas

- The Chromium row launches the browser through `capture.mjs --probe`, so it takes a few seconds
  and is the one row that proves playwright-core and its browser resolve together.
- A PASS on the Chromium row with an unset option can come from the working directory or a
  playwright-cli install on PATH: `capture.mjs` owns that lookup order.

