# video-batch-runner

Assembles Seedance 2.5 requests and runs one clip or a whole batch from a brief, image, audio or reference.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 27
- Author: PostPlusAI
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/40-creative/video-batch-runner/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/video-batch-runner

## What it does

The skill handles video generation end to end in PostPlus: it reads the brief, inspects the supplied media and picks the matching Seedance 2.5 mode. Six modes are covered — text-to-video, first-frame, first-last-frame, reference video, video edit and video extend. Field names and allowed values come from the live schema, fetched with `postplus media schema --endpoint <endpoint> --json`, so nothing is guessed from memory.

Each clip gets its own self-contained prompt: subject and action, product behaviour, scene, camera, timing, sound and the role of every reference. Local paths, HTTPS URLs and existing PostPlus references go straight into the matching role flags, with no pre-upload step. When a clip exceeds the supported duration, the skill advises splitting it into independent prompts before any credits are spent.

Finished output is pulled down with `postplus media-file download`. Inside a batch only `postplus_cli_hosted_media_content_policy_blocked` stays item-local: that item is marked blocked and the rest continue, while any other error stops the batch. You need the released `postplus` CLI and credits on the account — the skill checks price and balance first and stops on insufficient credits instead of suggesting a top-up.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill video-batch-runner -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/video-batch-runner/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/video-batch-runner/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill video-batch-runner -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/video-batch-runner/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill video-batch-runner -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/video-batch-runner/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostPlusAI/postplus-skills video-batch-runner
```

2. **Manually: put the files in place**
- File: `.github/skills/video-batch-runner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill video-batch-runner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostPlusAI/postplus-skills --path skills/40-creative/video-batch-runner
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/video-batch-runner/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostPlusAI/postplus-skills --skill video-batch-runner -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/PostPlusAI/postplus-skills/tree/HEAD/skills/40-creative/video-batch-runner/SKILL.md

## When to use it
- shape a prompt for the right Seedance 2.5 mode
- submit a batch of clips and track each run
- resume a pending run instead of resubmitting it
- download the finished clip to a local file
- bind image, video and audio references to their roles

## Example prompts
- Generate a video from brief.md using text-to-video and wait for it
- Make a clip from first.png and last.png, then download it to ./out/clip.mp4
- Submit three clips from the refs folder and report the status of each

## Similar
- [pixverse-ai-image-and-video-generator](https://affpapa.org/en/nevibecode/skills/pixverse-ai-image-and-video-generator.md) — skill · 1000 installs
- [muapi-social-media-video](https://affpapa.org/en/nevibecode/skills/muapi-social-media-video.md) — skill · 2800 installs
- [video-to-gif](https://affpapa.org/en/nevibecode/skills/video-to-gif.md) — skill · 3900 installs
- [batch-script-progress](https://affpapa.org/en/nevibecode/skills/batch-script-progress.md) — skill · 4 installs
- [batch-processor](https://affpapa.org/en/nevibecode/skills/batch-processor.md) — skill · 4800 installs
- [batch-convert](https://affpapa.org/en/nevibecode/skills/batch-convert.md) — skill · 4800 installs

From the same set: [postplusai/postplus-skills](https://affpapa.org/en/nevibecode/by/postplusai/postplus-skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md