acn-slide-gen — Setup

acn-slide-gen is the only V1 plugin with a setup step beyond --plugin-dir. The toolkit ships the skill, the pipeline scripts, and the flavor templates — but not the Python venv the scripts need.

One-time: Python venv

The pipeline scripts (decrypt_pptx.py, inspect_slide.py, inspect_theme.py) and the generated slide-build script all run against a Python venv with python-pptx, lxml, msoffcrypto-tool, and olefile.

python3 -m venv ~/.venv-pptx
~/.venv-pptx/bin/pip install python-pptx lxml msoffcrypto-tool olefile

~/.venv-pptx is the recommended path. The skill probes .venv-pptx/, then .venv/, then any venv with python-pptx. If none is found, it falls back to creating /tmp/.venv-pptx automatically — but a one-time ~/.venv-pptx is faster across sessions.

Per-session: directory conventions

By default, the skill resolves bare filenames in --content against slideware/input/ (relative to the working directory). Generated output lands in slideware/output/<content-name>.pptx for New Deck Mode unless --output is specified.

<working dir>/
├── slideware/
│   ├── input/      # bare-filename --content resolves here first
│   └── output/     # default --output for New Deck Mode

The directories are created on demand — no manual setup required.

Flavors

Two flavors ship in-repo: acn-standard and acn-anthropic. They live at ${CLAUDE_PLUGIN_ROOT}/assets/flavors/<name>/ and load at Phase 0 of the Pipeline. No installation step needed beyond cloning the repo. To add a new flavor, see Flavors.

Verifying setup

Run the skill against a registered flavor with sample content:

/acn-slide-gen:generate --new --flavor acn-standard --content sample.md

If the venv is missing or broken, the skill reports the failing exit code and path. Expected exit codes from decrypt_pptx.py: 0 (success), 1 (file not found), 2 (password failure), 3 (DRM-protected, no decrypted fallback found).