Skip to main content
skill CX Codex

product-video · pexoai — Claude Code skill for product videos

This Claude Code skill sends product photos to Pexo to create a product video. It activates for e-commerce clip requests, not explainers or other non-product videos.

MIT 123 installs ★ 835 updated 2026-08-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pexoai/pexo-skills --skill product-video -a claude-code
Open on GitHub

What product-video does

The skill passes product images and the request to Pexo, which assembles a clip with motion, music, and transitions. It creates a project, uploads supplied files, then sends the user's wording unchanged, adding only file tags. The finished asset and project link go back to the user.

Scripts handle uploads and project checks, which run at intervals of at least 60 seconds. Pexo cannot fetch store URLs, so linked images need to be downloaded before upload. The setup requires PEXO_API_KEY, PEXO_BASE_URL, and curl, jq, and file; processing uses Pexo and consumes credits.

What it helps with

  • create a product clip from photos
  • prepare video for a product listing
  • upload product images to a Pexo project
  • send revision requests for a finished clip

Example prompts for the agent

  • Make a product video from these photos.
  • Create a listing video using the images from this store link.
  • Change the music in the finished product clip.

How to install product-video

1Skills CLI (Vercel)

npx skills add pexoai/pexo-skills --skill product-video -a claude-code

2Manually: put the files in place

~/.claude/skills/product-video/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/product-video/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about product-video

How do I install product-video in Claude Code?

Run npx skills add pexoai/pexo-skills --skill product-video -a claude-code. The skill is placed at ~/.claude/skills/product-video/SKILL.md.

What does product-video do?

It sends product photos and the user's request to Pexo, which creates a clip with motion, music, and transitions. The skill is for product videos, not explainers.

What does product-video need to run?

It requires PEXO_API_KEY, PEXO_BASE_URL, plus curl, jq, and file. Video processing runs through Pexo and uses credits.

Source text

SKILL.md · MIT
---
name: product-video
description: >
  Turn product photos or a store URL into a polished product video with Pexo. Upload your product
  images (or download from a link, then upload) and Pexo composes the shots, adds motion, music,
  and transitions, and returns a publish-ready clip for your listing, ads, or socials. Use for
  e-commerce/product clips: "product video", "video for my product", "ecommerce video", "video
  from product photos". NOT for explainer or non-product content.
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
---

# Product Video — Pexo

**Pexo:** https://pexo.ai — get an API key, watch your project render, and buy credits there.

Turn a product's photos into a polished, publish-ready video. You upload the user's product
images and relay the request to the hosted Pexo agent, then deliver the result — Pexo composes
the shots, motion, and music.

## 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: "Make a 20-second product video from these three sneaker photos."

```bash
pid=$(pexo-project-create.sh "sneaker product video")
pexo-chat.sh "$pid" "Make a 20-second product video from these three sneaker photos."
# 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`.

© pexoai · MIT · pexoai/pexo-skills

Similar skills

All skills for Marketing and content →

product-video by other authors comes first.

product-video sanky369 Plans animated product videos, creates beat-by-beat shot lists with exact timings, and writes keyframe prompts for fal-ai/nano-banana-pro. CX Codex +1 218installs minimalist-product-ad-generator MiniMax-AI minimalist-product-ad-generator is a Claude Code skill that turns product images and an ad brief into a minimalist product video. It prepares copy and a shot plan for product launches and e-commerce promotion. CX Codex +1 3,600installs linkfox-echotik-product-video linkfox-ai linkfox-echotik-product-video — a Claude Code skill for evaluating affiliate videos linked to TikTok Shop products. It pulls engagement stats, estimated orders, and GMV per creator. CX Codex +1 329installs product-launch-strategy nexscope-ai product-launch-strategy — a skill that plans an e-commerce product launch: pre-launch checklist, launch-day playbook and post-launch review. Built for Amazon, Shopify and multi-channel sellers. CX Codex +1 1,300installs shopify-product-photography-guide nexscope-ai shopify-product-photography-guide — a skill that walks you through DIY product photography for a Shopify store: lighting, backgrounds, editing, lifestyle shots and 360 views. CX Codex +1 1,200installs product-photography 101-skills product-photography generates commercial product renders, e-commerce packshots, and lifestyle scenes. Relies on the belt CLI tool to run image models. CX Codex +1 66,100installs muapi-product-video-ad-maker SamurAIGPT muapi-product-video-ad-maker turns a plain product photo into a polished commercial still, then animates it into a short cinematic ad. Useful when you need a promo clip without a shoot. CX Codex +1 2,700installs

From the same set20

The whole set →
veo-3.2-prompter veo-3.2-prompter is a Claude Code, Codex, and Cursor skill that builds Google Veo 3.2 prompts from media and scene descriptions, triggered by Veo, Artemis, or video-generation requests. CX Codex +1 553installs image-to-video image-to-video animates still images into moving video clips with camera movement and music using the Pexo platform. CX Codex +1 132installs ai-video-generation ai-video-generation generates finished AI videos with music and subtitles through Pexo from text prompts, scripts, or images. CX Codex +1 130installs text-to-video text-to-video turns a written prompt or script into a finished video with multiple shots, music, and subtitles. Use it when the video should start from text. CX Codex +1 127installs explainer-video Claude Code skill creates narrated explainer videos and tutorials via Pexo. Runs when requested to generate a product walkthrough or tutorial video. CX Codex +1 122installs video-ad Automates generating promotional video ads through the Pexo service using a product description or brief. CX Codex +1 120installs youtube-short-maker youtube-short-maker — a skill for Claude Code and Codex that dispatches video prompts to the hosted Pexo pipeline to produce 9:16 YouTube Shorts. Renders complete short-form clips with music and captions in 15–20 minutes. CX Codex +1 118installs make-a-video The make-a-video Claude Code skill turns a written idea into a finished video through Pexo. It activates for requests to create a new video, not to edit an existing one. CX Codex +1 117installs

Project sponsors

Companies that keep this analytics open