# Explainer Video

> Crea un video explicativo narrado con Pexo: describe tu producto, concepto o proceso y Pexo escribe el guion, genera los visuales, añade voz en off y subtítulos.

Fuente: https://skillsagentes.com/skills/pexoai/pexo-skills/explainer-video
Markdown: https://skillsagentes.com/skills/pexoai/pexo-skills/explainer-video.md

Repositorio: https://github.com/pexoai/pexo-skills
Autor: pexoai
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 100 tok instalada, 1.3k tok al activarse, 15.1k tok con todos los archivos del bundle
Bundle: 13 archivos, 59 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add pexoai/pexo-skills --skill explainer-video --agent claude-code
# Cursor
npx -y skills add pexoai/pexo-skills --skill explainer-video --agent cursor
# Codex
npx -y skills add pexoai/pexo-skills --skill explainer-video --agent codex
# Gemini CLI
npx -y skills add pexoai/pexo-skills --skill explainer-video --agent gemini
# Windsurf
npx -y skills add pexoai/pexo-skills --skill explainer-video --agent windsurf
# Cline
npx -y skills add pexoai/pexo-skills --skill explainer-video --agent cline
```

## Qué hace

- Crea un proyecto en Pexo y envía la petición del usuario tal cual para generar un video explicativo
- Genera guion, visuales por escena, voz en off (TTS) y subtítulos de forma automática
- Sondea el estado del proyecto y gestiona respuestas, previsualizaciones y reintentos
- Entrega la URL final del video y gestiona revisiones reutilizando el mismo proyecto

## Cuándo usarla

- El usuario pide un video explicativo o tutorial sobre un producto, concepto o proceso
- El usuario pide algo tipo "explain this as a video" o "how it works video"

## Cuándo no

- El usuario pide un anuncio o promo (usar el skill video-ad)

## Qué la activa

- "Explica cómo funciona nuestra app de presupuestos en un video de 60 segundos"
- "Haz un video tutorial que explique este proceso paso a paso"
- "Necesito un explainer video sobre este concepto"

## Antes de instalar

- Requiere una cuenta Pexo con PEXO_API_KEY y PEXO_BASE_URL configurados en ~/.pexo/config, además de curl, jq y file.
- Necesita en el PATH: awk, curl, jq, sed
- Variables de entorno: BASH_VERSION, FAIL, PASS, PEXO_API_KEY, PEXO_BASE_URL, PEXO_CHAT_ACK_TIMEOUT, PEXO_CONFIG, PEXO_CONNECT_TIMEOUT, PEXO_LAST_HTTP_CODE, PEXO_REQUEST_TIMEOUT, PEXO_TMP_DIR, WARN
- makes network requests
- needs API credentials

## Archivos

- README.md — 1 KB
- SKILL.md — 5 KB
- references/SETUP-CHECKLIST.md — 2 KB
- references/TROUBLESHOOTING.md — 12 KB
- scripts/_common.sh — 11 KB
- scripts/pexo-asset-get.sh — 2 KB
- scripts/pexo-chat.sh — 4 KB
- scripts/pexo-doctor.sh — 5 KB
- scripts/pexo-entitlements.sh — 2 KB
- scripts/pexo-project-create.sh — 2 KB
- scripts/pexo-project-get.sh — 7 KB
- scripts/pexo-project-list.sh — 2 KB
- scripts/pexo-upload.sh — 3 KB

## SKILL.md

Reproducido tal cual desde pexoai/pexo-skills bajo MIT. Esta sección es el documento original y está en inglés.

# 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.

1. **Create a project:** `pexo-project-create.sh "<short brief>"` → save the `project_id`.
2. **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.
3. **Send the request:** `pexo-chat.sh <project_id> "<user's exact words> <asset tags>"`.
   Copy the user's words exactly; only add asset tags.
4. **Tell the user** (their language): submitted ✓ · ~15–20 min · `https://pexo.ai/project/<project_id>`.
5. **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."

```bash
pid=$(pexo-project-create.sh "budgeting app explainer")
pexo-chat.sh "$pid" "Explain how our budgeting app works in a 60-second video."
# Tell the user: submitted, ~15–20 min, https://pexo.ai/project/$pid
# Poll pexo-project-get.sh "$pid" until nextAction is DELIVER, then deliver the asset URL.
```

## 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`.

## Dónde encaja

- Categoría: [Redacción y contenido](https://skillsagentes.com/categorias/redaccion-contenido.md) — Redacción, edición y estructuración de contenido extenso.
- Creador: [pexoai](https://skillsagentes.com/creators/pexoai.md) — 0 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Pexo Agent](https://skillsagentes.com/skills/pexoai/pexo-skills/pexo-agent.md): Skill de generación de video con IA que selecciona modelo automáticamente entre Seedance 2, Kling 3.0, HappyHorse y más de 10 modelos, y produce videos multi-toma de 5–120s desde texto, imágenes, URLs, guiones o audio.
- [Ai Video Generation](https://skillsagentes.com/skills/pexoai/pexo-skills/ai-video-generation.md): Genera video con IA a partir de texto, imagen o guion: enruta cada toma al mejor de 10+ modelos (Seedance, Kling, Veo, Sora...) y entrega un video final con música y subtítulos.
- [Founder Video](https://skillsagentes.com/skills/pexoai/pexo-skills/founder-video.md): Crea un video de fundador con Pexo: cuenta tu historia o pitch y Pexo escribe el guion, genera las tomas y entrega un video listo para publicar, con música.
- [Image To Video](https://skillsagentes.com/skills/pexoai/pexo-skills/image-to-video.md): Anima una foto fija en un vídeo terminado con Pexo: añade movimiento, cámara y música, elige el mejor modelo automáticamente y entrega el clip listo para publicar.
- [Saas Video](https://skillsagentes.com/skills/pexoai/pexo-skills/saas-video.md): Crea un video demo o explicativo de tu SaaS con Pexo: describe tu software (o pega la URL o una captura) y recibe un video terminado y listo para publicar.

## Skills relacionadas

- [Writing Shape](https://skillsagentes.com/skills/mattpocock/skills/writing-shape.md): Escritura, fase exploit — da forma de artículo al material en bruto, párrafo a párrafo.
- [Writing For Agents](https://skillsagentes.com/skills/mattpocock/skills/writing-for-agents.md): Escribir documentos para agentes. Úsalo al crear o editar skills, o al modificar AGENTS.md o CLAUDE.md.
- [Internal Comms](https://skillsagentes.com/skills/anthropics/skills/internal-comms.md): Recursos para escribir todo tipo de comunicaciones internas con los formatos que usa tu empresa. Úsalo siempre que pidan informes de estado, updates de liderazgo, 3P, newsletters, FAQs o informes de incidencias.
- [Doc Coauthoring](https://skillsagentes.com/skills/anthropics/skills/doc-coauthoring.md): Guía al usuario por un flujo estructurado para co-escribir documentación. Úsalo cuando quiera escribir documentación, propuestas, specs técnicas o documentos de decisión.
- [Faceless Explainer](https://skillsagentes.com/skills/heygen-com/hyperframes/faceless-explainer.md): Convierte texto (artículo, notas, tema o brief) en un video explicativo faceless: sin sitio ni material que capturar, los visuales se inventan por escena (tipografía, gráficos abstractos, diagramas, data-viz).

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)