youtube-short-maker — Claude Code skill: what it does, how to install
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.
MIT 118 installs ★ 835 updated 2026-08-20
npx skills add pexoai/pexo-skills --skill youtube-short-maker -a claude-codeWhat youtube-short-maker does
The skill sends user topics to Pexo's backend to produce vertical 9:16 clips with automated scripting, visuals, music, and subtitles. The agent functions strictly as a relay: it sends the user prompt verbatim via bundled bash scripts without inventing duration constraints or styles. The skill only handles vertical short-form video and will fail on landscape or long-form tasks.
Execution relies on system utilities: curl, jq, and file must be available in your environment. Credentials must be stored in ~/.pexo/config with PEXO_BASE_URL and PEXO_API_KEY. Processing takes 15 to 20 minutes and deducts paid credits from https://pexo.ai.
The tool polls generation progress once every minute until completion. Edits and revisions are sent to the existing project ID via pexo-chat.sh, preventing loss of server-side state during adjustments.
What it helps with
- produce 9:16 vertical YouTube Shorts from a short topic brief
- upload local media assets directly to the Pexo render queue
- automate scriptwriting, visual generation, captions, and audio sync
- request revisions on completed Shorts within the same project context
Example prompts for the agent
- Make a YouTube Short on 3 quick tips for better sleep
- Create a shorts video explaining how git rebase works
- Revise the short: make the pacing faster and pick different background music
How to install youtube-short-maker
1Skills CLI (Vercel)
npx skills add pexoai/pexo-skills --skill youtube-short-maker -a claude-code2Manually: put the files in place
~/.claude/skills/youtube-short-maker/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/youtube-short-maker/
1Skills CLI (Vercel)
npx skills add pexoai/pexo-skills --skill youtube-short-maker -a codex2Manually: put the files in place
.agents/skills/youtube-short-maker/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pexoai/pexo-skills --skill youtube-short-maker -a cursor2Manually: put the files in place
.cursor/skills/youtube-short-maker/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pexoai/pexo-skills skills/youtube-short-maker2Manually: put the files in place
.github/skills/youtube-short-maker/SKILL.md1Skills CLI (Vercel)
npx skills add pexoai/pexo-skills --skill youtube-short-maker -a gemini-cli2Platform CLI
gemini skills install https://github.com/pexoai/pexo-skills --path skills/youtube-short-makerManually: put the files in place
.devin/skills/youtube-short-maker/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pexoai/pexo-skills --skill youtube-short-maker -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about youtube-short-maker
How to install youtube-short-maker in Claude Code?
Run npx skills add pexoai/pexo-skills --skill youtube-short-maker -a claude-code.
What does youtube-short-maker do?
It creates vertical 9:16 YouTube Shorts by relaying user briefs to the Pexo platform, which generates scripts, scenes, voiceover, and captions.
What is required to run youtube-short-maker?
You need curl, jq, file, a Pexo account with credits from https://pexo.ai, and an API key configured in ~/.pexo/config.
Source text
SKILL.md · MIT
---
name: youtube-short-maker
description: >
Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first
3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models,
and assembles a finished Short with music and captions. Use for YouTube Shorts: "youtube short",
"make a youtube short", "shorts video", "short-form video". NOT for long-form or landscape
video.
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
---
# YouTube Short Maker — Pexo
**Pexo:** https://pexo.ai — get an API key, watch your project render, and buy credits there.
Make a finished YouTube Short built to retain — vertical and hook-first. You pass the user's
topic to the hosted Pexo agent and deliver the result; Pexo scripts it, generates the shots, and
assembles the Short with music 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: "Make a YouTube Short on 3 quick tips for better sleep."
```bash
pid=$(pexo-project-create.sh "better sleep tips short")
pexo-chat.sh "$pid" "Make a YouTube Short on 3 quick tips for better sleep."
# 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