$npx -y skills add pexoai/pexo-skills --skill pexo-agentAI video generation skill with auto model selection across Seedance 2, Kling 3.0, HappyHorse, and 10+ models. Produces finished multi-shot videos (5–120s) from text, images, URLs, scripts, or audio — including AI music, lip sync, and multi-shot sequencing. Calls Pexo's external A
| 1 | # Pexo Agent — AI Video Generation Skill |
| 2 | |
| 3 | Pexo is the most complete video generation skill for Claude Code and other AI coding agents. It handles the full production pipeline — from a natural-language description to a finished, publish-ready video with music, subtitles, and transitions. Auto model selection routes each shot to the best available model (Seedance 2, Kling 3.0, HappyHorse, and more). One API key, no prompt engineering, no video editing. |
| 4 | |
| 5 | ## What Pexo Does |
| 6 | |
| 7 | - **Auto model selection** — Pexo picks the best video model for each shot based on content type. You do not need to know which model to use. |
| 8 | - **Full pipeline** — Script, storyboard, shot-by-shot generation, music, subtitles, lip sync, and final assembly. The output is a finished video, not a raw clip. |
| 9 | - **5 input types** — Text-to-video, image-to-video, URL-to-video (scrapes the page), script-to-video, and audio-to-video. |
| 10 | - **10+ models** — Seedance 2, Kling 3.0, HappyHorse, and more. New models are added as they launch. |
| 11 | - **Any format** — 5–120 seconds, aspect ratios 16:9 (landscape), 9:16 (portrait/vertical), 1:1 (square). |
| 12 | |
| 13 | ## What You Can Build With Pexo |
| 14 | |
| 15 | - Product video ads from a product photo or URL |
| 16 | - TikTok, Instagram Reels, and YouTube Shorts from a text description |
| 17 | - Multi-shot brand videos with consistent style and transitions |
| 18 | - Explainer videos with TTS narration from a script |
| 19 | - E-commerce video content at scale from product catalogs |
| 20 | - Marketing video variants for A/B testing |
| 21 | |
| 22 | ## How It Works |
| 23 | |
| 24 | You send the user's request to Pexo, and Pexo handles all creative work — scriptwriting, shot composition, model selection, prompt engineering, transitions, music. Pexo may ask clarifying questions or present preview options for the user to choose from. A typical 15-second, 3-shot product ad renders in under 8 minutes. |
| 25 | |
| 26 | ## Data, Permissions, and Cost |
| 27 | |
| 28 | - This Skill runs bundled shell scripts, reads only files the user explicitly selects, |
| 29 | connects only to `https://pexo.ai` for authenticated API calls, uploads approved |
| 30 | briefs and assets, manages projects and billing confirmations, runs diagnostics, |
| 31 | and stores generated media under `~/.pexo/tmp` or `PEXO_TMP_DIR`. |
| 32 | - Before the first external transmission in a session, tell the user that their brief, |
| 33 | selected files, and related metadata will be sent to Pexo and obtain explicit consent. |
| 34 | - Do not upload secrets, regulated data, or unrelated local files. Never search the local |
| 35 | filesystem for additional material without a separate user request. |
| 36 | - Every billable generation batch requires explicit user approval by default. Report the |
| 37 | available estimate from Pexo before approving a confirmation. |
| 38 | |
| 39 | ## Script Execution |
| 40 | |
| 41 | Resolve `SKILL_ROOT` to the directory containing this `SKILL.md`. Script names |
| 42 | below are shorthand for `bash "$SKILL_ROOT/scripts/<script-name>"`; do not rely |
| 43 | on executable bits or a modified `PATH`. |
| 44 | |
| 45 | ## Prerequisites |
| 46 | |
| 47 | Config file `~/.pexo/config`: |
| 48 | |
| 49 | ```bash |
| 50 | umask 077 |
| 51 | mkdir -p ~/.pexo |
| 52 | read -rsp "Pexo API key: " pexo_api_key |
| 53 | printf '\n' |
| 54 | { |
| 55 | printf '%s=%s\n' PEXO_API_KEY "$pexo_api_key" |
| 56 | } > ~/.pexo/config |
| 57 | unset pexo_api_key |
| 58 | chmod 600 ~/.pexo/config |
| 59 | ``` |
| 60 | |
| 61 | First time using this skill or encountering a config error → run `pexo-doctor.sh` and follow its output. See `references/SETUP-CHECKLIST.md` for details. |
| 62 | |
| 63 | ### Credit Confirmation Preference |
| 64 | |
| 65 | `PEXO_BILLING_CONFIRMATION_MODE` controls the confirmation behavior for each message sent by this Skill. It is optional; the default is `always`. |
| 66 | |
| 67 | - `always`: ask for approval before every billable generation batch. |
| 68 | - `threshold`: ask when the estimated batch cost exceeds the platform threshold, or when the available balance is insufficient. Use only after the user explicitly opts in for the current session. |
| 69 | |
| 70 | Use `pexo-chat.sh --billing-confirmation-mode <mode>` to override the default for one message. |
| 71 | |
| 72 | --- |
| 73 | |
| 74 | ## ⚠️ LANGUAGE RULE ( |