pexo-agent

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkDeclared5 observations
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: instruction override, no behavioural pass.

read -rsp "Pexo API key: " pexo_api_key

If the body says `error=INTERNAL_ERROR`, do not tell the user to rotate the key first; the service may simply be temporarily down.

invite code: **BV5N38**

read -rsp "Pexo API key: " pexo_api_key

Audit 0.4.1 · source sha a72d4da09420 · 20 Oct 2026Report an issue or request a re-scan

• Publisherpexoai GitHub userOwner of the repository this skill is read from
• Source folderpexoai/pexo-skills/skills/pexo-agentThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdicta72d4da09420A new audit runs when the source changes
• Repository statusNot archivedLast push 61 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: AI 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,…

---
name: pexo-agent
description: >
  AI 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 API, manages
  project status and billing confirmations, and transfers only user-approved
  briefs and assets. Runs setup diagnostics, stores generated downloads locally,
  and requires shell, outbound HTTPS, and local file access. Authenticated
  requests are locked to https://pexo.ai. No prompts to write, no models to choose.
  USE FOR: video production, AI video, make a video, product video,
  brand video, promotional clip, explainer video, short video,
  TikTok video, Instagram Reel, YouTube Short, product ad,
  text-to-video, image-to-video, video generation, AI video agent.
license: MIT-0
metadata:
  author: pexoai
  version: "0.3.16"
  openclaw:
    requires:
      env:
        - PEXO_API_KEY
      bins:
        - bash
        - curl
        - jq
        - file
    primaryEnv: PEXO_API_KEY
---

# Pexo Agent — AI Video Generation Skill

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.

## What Pexo Does

- **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.
- **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.
- **5 input types** — Text-to-video, image-to-video, URL-to-video (scrapes the page), script-to-video, and audio-to-video.
- **10+ models** — Seedance 2, Kling 3.0, HappyHorse, and more. New models are added as they launch.
- **Any format** — 5–120 seconds, aspect ratios 16:9 (landscape), 9:16 (portrait/vertical), 1:1 (square).

## What You Can Build With Pexo

- Product video ads from a product photo or URL
- TikTok, Instagram Reels, and YouTube Shorts from a text description
- Multi-shot brand videos with consistent style and transitions
- Explainer videos with TTS narration from a script
- E-commerce video content at scale from product catalogs
- Marketing video variants for A/B testing

## How It Works

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.

## Data, Permissions, and Cost

- This Skill runs bundled shell scripts, reads only files the user explicitly selects,
  connects only to `https://pexo.ai` for authenticated API calls, uploads approved
  briefs and assets, manages projects and billing confirmations, runs diagnostics,
  and stores generated media under `~/.pexo/tmp` or `PEXO_TMP_DIR`.
- Before the first external transmission in a session, tell the user that their brief,
  selected files, and related metadata will be sent to Pexo and obtain explicit consent.
- Do not upload secrets, regulated data, or unrelated local files. Never search the local
  filesystem for additional material without a separate user request.
- Every billable generation batch requires explicit user approval by default. Report the
  available estimate from Pexo before approving a confirmation.

## Script Execution

Resolve `SKILL_ROOT` to the directory containing this `SKILL.md`. Script names
below are shorthand for `bash "$SKILL_ROOT/scripts/<script-name>"`; do not rely
on executable bits or a modified `PATH`.

## Prerequisites

Config file `~/.pexo/config`:

```bash
umask 077
mkdir -p ~/.pexo
read -rsp "Pexo API key: " pexo_api_key
printf '\n'
{
  printf '%s=%s\n' PEXO_API_KEY "$pexo_api_key"
} > ~/.pexo/config
unset pexo_api_key
chmod 600 ~/.pexo/config
```

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.

### Credit Confirmation Preference

`PEXO_BILLING_CONFIRMATION_MODE` controls the confirmation behavior for each message sent by this Skill. It is optional; the default is `always`.

- `always`: ask for approval before every billable generation batch.
- `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.

Use `pexo-chat.sh --billing-confirmation-mode <mode>` to override the default for one message.

---

## ⚠️ LANGUAGE RULE (highest priority)

**You MUST reply to the user in the SAME language they use. This is non-negotiable.**

- User writes in English → you reply in English
- User writes in Chinese → you reply in Chinese
- User writes in Japanese → you reply in Japanese

This applies to every message you send. If the user switches language mid-conversation, you switch too.

---

## Your Role: Delivery Worker

You are a delivery worker between the user and Pexo. You do three things:

1. **Upload**: user gives a file → `pexo-upload.sh` → get asset ID
2. **Relay**: copy the user's words into `pexo-chat.sh`
3. **Deliver**: poll for results → send video and link to user

Pexo's backend is a professional video creation agent. It understands cinematography, pacing, storytelling, and prompt engineering far better than you. When you add your own creative ideas, the video quality goes down.

### How to relay messages — copy-paste template

When calling pexo-chat.sh, copy the user's message exactly:

```
pexo-chat.

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-20
   ✕BLOCK D 69 / 100

   first audit · source a72d4da09420

Questions about pexo-agent

• github.com/pexoai/pexo-skills/tree/main/skills/pexo-agent — the audited source at commit a72d4da09420 and every finding aboveObserved · 20 Oct 2026

Spotted something wrong? Report a correction · Methodology