/sn-ppt-doctor

name: sn-ppt-doctor
description: |
  Environment diagnostic for the PPT family. Validates sn-image-base, API keys,
  Node runtime, and optional deps; interactively writes .env for required vars.
  Runs before sn-ppt-entry; does not modify sn-image-* skills.
metadata:
  project: SenseNova-Skills
  tier: aux
  category: diagnostic
  user_visible: true
triggers:
  - "sn-ppt-doctor"
  - "ppt 体检"

sn-ppt-doctor

When to use

• Before the first time you use `sn-ppt-entry` / `sn-ppt-creative` / `sn-ppt-standard`, to verify env is wired
• After you change `.env`, to confirm
• When `sn-ppt-entry` reports missing-env error and tells you to come here

Hard checks (must pass before sn-ppt-entry can run)

1. Text chat API key is available via `SN_TEXT_API_KEY`, shared `SN_CHAT_API_KEY`, or global `SN_API_KEY` 2. Vision chat API key is available via `SN_VISION_API_KEY`, shared `SN_CHAT_API_KEY`, or global `SN_API_KEY` 3. Image generation API key is available via `SN_IMAGE_GEN_API_KEY` or global `SN_API_KEY` 4. `sn-image-base` is discoverable and `sn_agent_runner.py --help` works (auto-resolved as a sibling skill under the same `skills/` directory; `SN_IMAGE_BASE` only needed for non-standard layouts) 5. `node --version` >= 18

Soft checks (warnings only)

• `$(pwd)/ppt_decks/` creatable and writable (deck_dir parent; fixed — not configurable via env)
• `sn-ppt-standard/scripts/export_pptx/node_modules` exists (run `npm install` on first use otherwise)
• Optional env vars (`SN_IMAGE_GEN_*`, `SN_CHAT_*`, `SN_TEXT_*`, `SN_VISION_*`) — displays current value or "unset"
• `pypdf` / `python-docx` Python deps for doc parsing in sn-ppt-entry

Invocation

Single-file entry; no package imports, no `-m`, no `PYTHONPATH` needed.

python $SKILL_DIR/ppt_doctor/check_environment.py                      # interactive
python $SKILL_DIR/ppt_doctor/check_environment.py --non-interactive
python $SKILL_DIR/ppt_doctor/check_environment.py --env-path /custom/.env

When used inside OpenClaw, `/skill sn-ppt-doctor` runs the same entry.

Output

Plain text report — one line per check — then a summary. On any hard-check failure, enters interactive mode to fill `.env` (unless `--non-interactive`).

Does NOT

• Modify `sn-image-*` skills or their `.env`
• Install packages automatically (prints install commands instead)
• Run any PPT pipeline