# Generate finished videos with AI in Claude Code

Making professional videos requires choosing models, writing prompts, and editing footage. Pexo Agent lets you describe what you want in plain language and delivers a finished video with music and subtitles.

## Install

```bash
npx skillstore add pexoai/pexo-agent
```

## Metadata

- - Slug: pexoai-pexo-agent
- - Version: 0.3.11
- - Author: pexoai
- - GitHub username: pexoai
- - License: MIT
- - Repository: https://github.com/pexoai/pexo-skills/tree/main/skills/pexo-agent/
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: low
- - Risk factors: scripts, network, filesystem, env\_access, external\_commands
- - Quality score: 81
- - Quality tier: silver
- - Public page: https://skillstore.pages.dev/skills/pexoai-pexo-agent
- - Manifest: https://skillstore.pages.dev/api/skills/pexoai-pexo-agent/manifest

## Capabilities

- Creates finished multi-shot videos \(5–120 seconds\) from text descriptions, images, URLs, scripts, or audio files
- Auto-selects the best video generation model per shot across Seedance 2, Kling 3.0, HappyHorse, and 10\+ models
- Produces videos with AI music, TTS narration, lip sync, and subtitles already included
- Supports 16:9 landscape, 9:16 vertical, and 1:1 square aspect ratios for any platform
- Handles the full pipeline: project creation, asset upload, chat-based direction, status polling, and delivery

## Use Cases

- Product video ads from a photo: Upload a product photo and get a finished promotional video suitable for social media ads.
- Short-form social content: Describe a concept in text and receive a vertical video ready for TikTok, Instagram Reels, or YouTube Shorts.
- Explainer videos with narration: Provide a script and get a video with TTS voiceover, visuals, and subtitles assembled automatically.

## Prompt Templates

### Simple product video

```
Create a 15-second product video for my [product name]. It should be energetic and modern, with upbeat music.
```

### Brand story with multiple shots

```
Make a 60-second brand video for [company name]. Show our workshop, our team, and a close-up of our craftsmanship. Use warm cinematic tones.
```

### Script-to-video with narration

```
Here is my script: [paste script]. Create a 45-second explainer video with professional narration and clean motion graphics style.
```

### Revision request

```
Make the colors more vibrant, shorten the intro to 2 seconds, and add a call-to-action text at the end saying 'Shop now'.
```

## Limitations

- Requires a Pexo API key \(PEXO\_API\_KEY\) configured in ~/.pexo/config
- Video generation takes 8–20 minutes depending on length and complexity
- Each message to Pexo costs tokens from your credit balance
- Cannot crawl web URLs directly — files must be downloaded and uploaded manually

## Best Practices

- Relay the user's exact words to Pexo — do not add your own creative direction or prompt engineering
- Poll pexo-project-get.sh every 60 seconds during WAIT status; never call pexo-chat during WAIT to avoid duplicate production
- Send the full video URL as plain text with all query parameters when delivering the finished video

## Anti Patterns

- Do not add duration, aspect ratio, or style details the user did not mention — let Pexo decide based on its expertise
- Do not call pexo-chat.sh while the project status is WAIT — it triggers duplicate video production and wastes credits
- Do not truncate or markdown-wrap the delivery URL — missing query parameters cause 403 errors

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-08T09:47:39.082\+00:00
- - Summary: Evaluation of 537 static findings confirms the skill is a legitimate API wrapper for the Pexo video generation service. The vast majority of findings are false positives expected for any shell-based API client: shell command substitution in bash scripts, access to the documented config file at ~/.pexo/config, and references to the PEXO\_API\_KEY environment variable. Network traffic is restricted to the user-configured PEXO\_BASE\_URL \(defaults to pexo.ai\). 'Weak cryptographic algorithm' findings are md5sum calls used for file integrity checks of downloaded assets, not security-sensitive operations. The 'dangerous combination' heuristic is a standard pattern for authenticated API client skills and poses no concrete risk. No data exfiltration, obfuscation, or prompt injection detected.

## Stats

- - Views: 0
- - Downloads: 2
- - Favorites: 1
- - Popularity score: 0