| name | explainer-video |
| description | Create an explainer video with narration using Pexo. Describe your product, concept, or process and Pexo writes the script, generates visuals shot by shot, adds TTS voiceover and captions, and assembles a clear, finished explainer. Use for explainer/tutorial content: "explainer video", "explain this as a video", "tutorial video", "how it works video". NOT for ads or promos (use the video-ad skill).
|
| homepage | https://pexo.ai |
| repository | https://github.com/pexoai/pexo-skills |
| version | 0.1.0 |
| requires | {"env":["PEXO_API_KEY","PEXO_BASE_URL"],"runtime":["curl","jq","file"]} |
| metadata | {"author":"pexoai"} |
Explainer Video — Pexo
Pexo: https://pexo.ai — get an API key, watch your project render, and buy credits there.
Produce a clear, narrated explainer video. You relay the user's topic to the hosted Pexo agent
and deliver the result; Pexo writes the script, generates the visuals shot by shot, and adds
voiceover and captions.
Your role: relay, don't create
Create a project, send the user's request verbatim, poll, deliver. Pexo's backend handles
all creative work — scriptwriting, model choice, prompts, music. Adding your own direction
(duration, style, models the user didn't ask for) overrides its judgment and produces worse
videos.
Config
~/.pexo/config:
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"
No account / first run → read references/SETUP-CHECKLIST.md and walk the user through it — it carries the signup flow with the invite code that grants new users bonus credits, plus how to create the config above. Config error → run scripts/pexo-doctor.sh and follow its output.
Workflow
Scripts live in this skill's scripts/. Reply to the user in their language.
- Create a project:
pexo-project-create.sh "<short brief>" → save the project_id.
- Upload any files the user gave:
pexo-upload.sh <project_id> <path> → save asset_id,
reference it inline as <original-image>asset_id</original-image> (or <original-video> /
<original-audio>). Tags are required — a bare asset_id is ignored. Pexo can't crawl URLs —
download, then upload.
- Send the request:
pexo-chat.sh <project_id> "<user's exact words> <asset tags>".
Copy the user's words exactly; only add asset tags.
- Tell the user (their language): submitted ✓ · ~15–20 min ·
https://pexo.ai/project/<project_id>.
- Poll: every ≥60s run
pexo-project-get.sh <project_id> and act on nextAction:
- WAIT → keep polling; every ~5 polls send a one-line update with the project link.
- RESPOND → handle each event in
recentMessages: relay Pexo's text (wait for the
user's answer if it asked, then pexo-chat.sh their reply); for preview_video, run
pexo-asset-get.sh <project_id> <assetId> per option, show the URLs (A/B/C), let the user
pick, then pexo-chat.sh <project_id> "<choice>" --choice <assetId>; for a document
event, mention it to the user.
- DELIVER →
pexo-asset-get.sh <project_id> <final assetId>, then send the user the
full asset URL as plain text — all ?… query params, never truncated or wrapped in
markdown — plus the project link.
- FAILED → explain
nextActionHint in plain terms and offer to retry.
- RECONNECT →
pexo-chat.sh <project_id> "continue", tell the user the connection
dropped and you're resuming, then keep polling.
- Never call
pexo-chat.sh during WAIT — it triggers duplicate production.
- Taking too long → if it's been >30 min and still WAIT, tell the user (with the project
link +
https://pexo.ai/connect/openclaw) it's running long; ask whether to keep waiting or
stop. Don't poll forever.
Revisions
After delivery, the user's tweaks ("make it shorter", "new music", "different shot") reuse the
same project: pexo-chat.sh <project_id> "<their feedback>", then poll again (step 5). Never
create a new project for a revision — it throws away Pexo's server-side context.
Credits
If a script fails with "Credits balance" / "Insufficient credits": if the error carries a
purchase link, pass it to the user; otherwise tell them to add credits at https://pexo.ai/home
→ Credits → Buy Credits. Retry after they confirm.
Example
User: "Explain how our budgeting app works in a 60-second video."
pid=$(pexo-project-create.sh "budgeting app explainer")
pexo-chat.sh "$pid" "Explain how our budgeting app works in a 60-second video."
Scripts
| Script | Usage | Returns |
|---|
pexo-project-create.sh | "<brief>" | project_id |
pexo-upload.sh | <project_id> <file> | asset_id |
pexo-chat.sh | <project_id> "<message>" [--choice <id>] | ack (async) |
pexo-project-get.sh | <project_id> | JSON: nextAction, recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | JSON with url |
pexo-doctor.sh | — | setup diagnostic |
Error codes and edge cases → references/TROUBLESHOOTING.md.
