doctor

motiscope: doctor

Verify dependencies and scaffold config. motiscope's pipeline is pure Python standard library, so the only hard dependencies are ffmpeg and ffprobe.

Resolve the scripts directory

SCRIPTS="${CLAUDE_PLUGIN_ROOT:-}/scripts"
[ -f "$SCRIPTS/mvsetup.py" ] || SCRIPTS="<absolute dir of this SKILL.md>/../../scripts"

(Windows: use python.)

Run status

python3 "$SCRIPTS/mvsetup.py" --json

The JSON reports status, missing_binaries, install_hint, platform, config_file, env_file, and per-provider key presence.

If ffmpeg/ffprobe are missing

Do not install silently. Ask the user for permission (AskUserQuestion), then run the platform command:

• macOS (Homebrew): brew install ffmpeg
• Linux: sudo apt-get install -y ffmpeg (or sudo dnf install ffmpeg)
• Windows: winget install Gyan.FFmpeg (or choco install ffmpeg)

Re-run mvsetup.py --check afterward to confirm (exit 0 = ready).

Scaffold config

python3 "$SCRIPTS/mvsetup.py"

This creates, if absent:

• ~/.config/motiscope/config.json — non-secret preferences (default_target, frame_budget, resolution, frame_format, image_provider, video_provider).
• ~/.config/motiscope/.env (mode 0600) — optional API keys for asset generation, commented out by default.

API keys (optional)

Asset generation (creating an image an animation needs) is optional — no key is required for analysis or code recreation. Image generation is real for Gemini/Imagen; the other providers write a labeled placeholder until wired. To configure one, ask the user (AskUserQuestion) which provider, and write the key into ~/.config/motiscope/.env:

Purpose	Providers (env var)
Image	Gemini/Imagen (GEMINI_API_KEY) — implemented; OpenAI (OPENAI_API_KEY), Stability (STABILITY_API_KEY), Replicate (REPLICATE_API_TOKEN), fal (FAL_KEY)
Video	Runway (RUNWAY_API_KEY), Replicate (REPLICATE_API_TOKEN), fal (FAL_KEY)

Image generation works today with gemini (Imagen). Other providers write a labeled placeholder until wired.

Reassure the user: keys stay in a local 0600 file, are never printed, never written into generated code, and never committed (the repo .gitignore excludes .env).

Report back

Summarize: dependency status, what was scaffolded, and whether any provider keys are configured. If everything is ready, say so in one line and point them at /motiscope:analyze.