Skill

/ppv:setup — bootstrap the PaperView toolchain

From ppv

One-time toolchain bootstrap for PaperView (Python venv, Remotion deps, local models). Run once before /ppv:gen.

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/ppv:setup

User invocable

Model invocation disabled

Inline context

Default effort

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

Provision everything `/ppv:gen` needs to run locally. This is idempotent — safe to re-run.

32 lines · ~315 tokens

Stats

LanguagePython

Parent stars0

MaintenanceExcellent

Last CommitJun 3, 2026

Actions

Stats

Actions

Provision everything /ppv:gen needs to run locally. This is idempotent — safe to re-run.

Locate the paperview repo (the directory containing core/ and scripts/setup.sh). Try, in order: the current working directory, then git rev-parse --show-toplevel, then search nearby (find . ~ -maxdepth 4 -name setup.sh -path '*paperview/scripts*' 2>/dev/null). If you cannot find it, ask the user where they cloned paperview.
Run the setup script and stream its output:
```
bash <repo>/scripts/setup.sh
```
It creates ~/.paperview/venv with the ppv CLI, installs the Remotion node deps, checks ffmpeg, and warms the Supertonic + Chromium models (first run downloads them — may take a few minutes).
Confirm health by running the doctor and showing its output:
```
~/.paperview/venv/bin/ppv doctor
```
Report success and tell the user they can now run /ppv:gen <pdf path and any options>. If ffmpeg was missing, tell them to install it and re-run setup.