whatsapp-automation: Skill for Claude Code

/watch

Run the bundled Python script. With the gemini engine (a GEMINI_API_KEY is configured) Google's video model watches the video and the report carries its timestamped answer for you to relay. With the local engine the script produces timestamped frames and a transcript; view the frames and answer from that evidence. Native captions come first; the chosen local or cloud backend is only a fallback. Transcript-only evidence cannot establish visual facts.

Resolve the skill and interpreter

SKILL_DIR is the absolute directory containing this SKILL.md; scripts/ sits beside it.

Commands below use python3 for macOS/Linux. On Windows, verify a working Python 3.10+ with python --version or py -3 --version and use that interpreter. python3 is not always a Store alias; inspect the actual result. In PowerShell use $SKILL_DIR rather than Bash variable syntax, for example:

python "$SKILL_DIR/scripts/setup.py" --json

Use the host's available shell, image viewer, and question tool. AskUserQuestion and Bash are examples, not requirements for every host.

First run and setup

On the first invocation in a session:

python3 "${SKILL_DIR}/scripts/setup.py" --json

• can_proceed depends on base binaries for the local engine, not optional credentials. If it is false, run setup.py and confirm the binaries become available. macOS uses Homebrew; other systems get package commands. Do not use sudo automatically. With the Gemini engine (engine is gemini, binaries_required false), missing ffmpeg/yt-dlp do not block YouTube URLs but are still needed for other URLs and for --engine local; mention missing_binaries only when that matters.
• If first_run is false, proceed without announcing successful setup or asking preferences again. Existing installations without a backend setting retain auto (Groq key first, then OpenAI).
• If first_run is true, ask the engine question first, then (local engine only) the two choices below it. The wizard does not inspect RAM, disk, CPU, browser sessions, or other machine state; the user decides from the stated requirements.