Pexo Agent Skill for Claude Code: Make Finished AI Videos

Makes Claude produce finished multi-shot AI videos through Pexo from text, images, links, scripts or audio.

Installs: 40.5K; on skills.sh
Stars: 817; on GitHub
Files: 12; besides SKILL.md
Updated: Aug 2026; last repo commit

pexo-agent makes Claude a delivery worker for Pexo, a hosted AI video service. You describe the video and share any images, video or audio. Claude relays your words, waits while Pexo writes, shoots and assembles it, then hands you the finished file and link.

It needs a Pexo API key and runs bundled shell scripts that talk to pexo.ai. Billable generations use credits, and Claude must ask you before each batch by default.

Good for

Marketers making product ads, Reels, TikToks or Shorts
Founders who want an explainer or launch video without editing
Creators who want AI video without choosing between models

Install pexo-agent

Claude Code

Copy this prompt.

Install the pexo-agent skill in Claude Code. Run this command:

npx skills add https://github.com/pexoai/pexo-skills --skill pexo-agent

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

What Pexo Does
What You Can Build With Pexo
How It Works
Data, Permissions, and Cost
Script Execution
Prerequisites
Credit Confirmation Preference
⚠️ LANGUAGE RULE (highest priority)
Your Role: Delivery Worker
How to relay messages — copy-paste template
When the user's request is vague
Why this matters
First-Time Setup Message
Step-by-Step Workflow
Making a New Video
Credit Error Handling

Key facts

Author: pexoai (metadata.author in SKILL.md)
License: MIT-0 (license field in SKILL.md)
Version: 0.3.16 (metadata.version in SKILL.md)
Installs on skills.sh: 40,494 as of 2026-11-02
GitHub stars: 817 for the whole pexoai/pexo-skills repo, 2026-11-02
Last repo commit: 2026-08-20
What is inside: 13 files including SKILL.md: 9 shell scripts (8 commands and a shared helper), 2 reference guides and agents/openai.yaml
Needs: A Pexo API key (PEXO_API_KEY), plus bash, curl, jq and file (frontmatter); shell, outbound HTTPS and local file access
Cost: Billable generations use Pexo credits; each batch needs your approval by default. Prices are not stated in SKILL.md.
Works in: README lists Claude Code, Cursor, OpenClaw and ClawHub

What it includes

Prints a setup report: tools, config and connection
Run it the first time or after a config error. SKILL.md also points to references/SETUP-CHECKLIST.md.
Runs code · pexo-doctor.sh
Creates a Pexo project and returns its ID
Every new video starts here. Revisions reuse the same project.
Runs code · pexo-project-create.sh
Uploads one image, video or audio file you choose
Returns an asset ID that Claude tags into your message. Supported types include jpg, png, webp, mp4, mov, mp3 and wav.
Runs code · pexo-upload.sh
Sends your words to Pexo exactly as written
Claude is a relay: it adds only asset tags and does not add its own creative ideas. Pexo asks the follow-up questions.
Try: “I want a product video for my shoes”
Runs code · pexo-chat.sh
Polls the project and reports the next action
Claude waits at least 60 seconds between polls and acts on WAIT, CONFIRM, RESPOND, DELIVER, FAILED or RECONNECT. After 30 minutes it stops and asks you.
Runs code · pexo-project-get.sh
Approves a credit estimate after you say yes
Refuses to contact Pexo unless Claude passes the flag showing you approved. Claude may not approve for you.
Runs code · pexo-billing-confirm.sh
Downloads the finished video to ~/.pexo/tmp
Returns the download URL and local path. The default is a clean copy; the watermarked copy is only fetched if you ask.
Runs code · pexo-asset-get.sh
Lists your Pexo projects
Takes an optional page size.
Runs code · pexo-project-list.sh
Stops on low credits and sends you a purchase link
If credits run out, Claude tells you and waits until you confirm you added more before retrying.
Read · Credit handling

From the official docs

Permissions

Medium risk

Claude runs shell scripts that send your brief and chosen files to pexo.ai and can spend your Pexo credits. Keep the default approval before every billable batch and upload nothing private.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your brief and files are sent to pexo.ai
SKILL.md has Claude tell you and ask consent before the first transmission in a session. Do not upload secrets, regulated data or unrelated files. github.com
It spends credits on your Pexo account
Every billable batch needs your approval by default. A threshold mode skips some approvals; SKILL.md says to use it only after you opt in for the session. github.com
Your API key lives in a file on disk
The setup command writes ~/.pexo/config with owner-only permissions. Use a key you can revoke, and keep the file out of backups and git. github.com
It runs scripts and writes downloads locally
The scripts call curl and jq and save generated media in ~/.pexo/tmp. The helper refuses to send your key to any base URL other than https://pexo.ai. github.com
Web page links in your brief are passed to Pexo
SKILL.md lets Pexo process a public https page URL you include in the brief. For direct media links Claude must ask before downloading, and it never fetches private or localhost URLs. github.com

Technical details

Talks to	https://pexo.ai for authenticated API calls (SKILL.md). pexo-upload.sh asks Pexo for an upload credential, then sends your file with an HTTP PUT to the presigned upload URL Pexo returns (pexo-upload.sh). A signed storage link that Pexo returns, for downloading the finished video (pexo-asset-get.sh)
Sign-in and keys	PEXO_API_KEY in ~/.pexo/config (created with mode 600 per SKILL.md) or in the environment.
Scopes	Runs 9 bundled shell scripts Uploads only files you choose to Pexo Saves generated media under ~/.pexo/tmp or PEXO_TMP_DIR Spends Pexo credits after your approval

Questions

What does the pexo-agent skill do?

It makes Claude produce finished AI videos through Pexo's service. You describe the video, Claude relays your words and files, Pexo chooses models and builds it, and Claude delivers the download link and file.

How do I install pexo-agent?

Use the install box at the top of this page. Then you need a Pexo API key: SKILL.md shows how to save it in ~/.pexo/config, and the pexo-doctor.sh script checks your setup.

Does it cost money?

Yes. Pexo bills in credits, and SKILL.md states no prices. By default Claude must show the estimate and get your explicit approval before every billable batch. SKILL.md says both the clean and the watermarked download need an active subscription or a watermark whitelist.

How long does a video take?

The README says a 15-second, 3-shot product ad typically renders in under 8 minutes and a 60-second brand video takes around 20. SKILL.md has Claude tell you to expect 15 to 20 minutes for a short video.

Can I choose the video model?

No. SKILL.md says Pexo picks the best model for each shot, such as Seedance 2 or Kling 3.0. Claude passes your request through unchanged and adds no creative direction of its own.

Is pexo-agent safe?

It runs shell scripts that send your brief and chosen files to pexo.ai and download results to ~/.pexo/tmp. SKILL.md has Claude get your consent before the first upload each session. Do not send secrets or private files, and keep the default billing approval on.

Does it work in the Claude app, Cursor or Codex?

It needs shell access, outbound HTTPS and local file access, so it needs a coding agent. The README lists Claude Code, Cursor, OpenClaw and ClawHub. It does not document the Claude app or Codex.

pexo-agent vs product-video, video-ad and the other Pexo skills?

The README calls the others focused entry points to the same Pexo agent and says pexo-agent does all of it. Install a narrower one only if it matches your job.

Information

updated Nov 2, 2026

Repository: pexoai/pexo-skills
Folder: skills/pexo-agent

pexoai/pexo-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

pexo-agent SKILL.md · github.com
pexo-agent scripts/_common.sh · github.com
pexoai/pexo-skills README · github.com
pexo-upload.sh · github.com
pexo-asset-get.sh · github.com