# video-plan

Turns rough concepts into timed, scene-by-scene plans for short videos, vlogs, and social clips. It splits footage into 4-15 second cuts and sets a visual tone.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 301 installs · ★ 618
- Author: agentara
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/agentara/skills/tree/HEAD/skills/aigc/video-plan/SKILL.md
- Updated: 2026-09-29
- HTML: https://affpapa.org/en/nevibecode/skills/video-plan

## What it does

This skill builds production-ready scene breakdowns for short-form clips, travel vlogs, and AI video generators. Before writing scenes, the agent checks constraints like aspect ratio, audience, characters, and visual references. If total duration is omitted, it defaults to 60 seconds, with standard presets available for 30, 45, 60, or 90 seconds.

Every scene follows strict timing constraints between 4 and 15 seconds. It favors increments of 4, 9, 12, or 15 seconds so the sequence matches the total runtime. For each cut, the plan details shot type, character actions, props, wardrobe, and editing rhythm. Fast cuts under 4 seconds are filtered out by design. This keeps the pacing deliberate.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add agentara/skills --skill video-plan -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add agentara/skills --skill video-plan -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add agentara/skills --skill video-plan -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install agentara/skills video-plan
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add agentara/skills --skill video-plan -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/agentara/skills --path skills/aigc/video-plan
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add agentara/skills --skill video-plan -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/agentara/skills/tree/HEAD/skills/aigc/video-plan/SKILL.md

## When to use it
- Split a short video concept into timed scenes between 4 and 15 seconds
- Set visual tone and camera style using photography and director references
- Calculate exact scene durations for 30, 45, 60, or 90-second edits
- Detail shot types, character actions, wardrobe, and props for each cut

## Example prompts
- Create a scene-by-scene plan for a 60-second travel vlog in Tokyo
- Build a storyboard for a 30-second product launch Reel
- Write a 90-second documentary breakdown inspired by Sofia Coppola

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b113b2b5af67cc40.

BEGIN THIRD-PARTY FILE b113b2b5af67cc40
```text
---
name: video-plan
description: Plan short-form video, vlog, travel, lifestyle, documentary, or cinematic social video scripts by negotiating duration, choosing a story arc and visual style, then splitting the film into timed scenes of 4-15 seconds. Use this skill whenever the user asks for a video plan, short video plan, scene breakdown, montage plan, travel video script, TikTok/Reels/Shorts storyboard, or cinematic short-form narrative, even if they only describe a loose theme or destination.
---

# Video Plan

Use this skill to turn a user's short-film idea into a practical, scene-by-scene production plan. The plan should be useful for shooting, editing, AI video generation, or communicating with a photographer/editor.

The final plan should be written in the user's preferred local language. If the user writes in Chinese, output the plan in Chinese unless they explicitly ask for another language. Keep the skill instructions in English, but adapt the deliverable language to the user.

## Primary Goals

Create a complete short-video plan that:

- Negotiates or infers the total duration.
- Splits the video into scenes, where each scene is at least 4 seconds and no more than 15 seconds.
- Prefer scene durations of 4, 9, 12, or 15 seconds when practical.
- Uses a recognizable story arc, such as 起承转合, setup-conflict-turn-resolution, three-act structure, or hook-build-payoff.
- Recommends several style directions and chooses one based on the user's preference.
- Defines a coherent visual tone using references from photography styles, directors, films, or creator aesthetics.
- Includes shot type, scene description, character action, wardrobe suggestions, scenery/prop details, and editing rhythm for every scene.

## First Response Workflow

When a user asks for a video or short-film plan, first extract any constraints they already gave:

- Topic or title
- Intended platform and aspect ratio
- Total duration
- Destination or setting
- Characters
- Voiceover or dialogue
- Emotional goal
- Target audience
- Required locations, props, brands, or products
- Preferred language
- Available footage versus plan for future shooting

If essential details are missing, ask concise questions before writing the final plan. Do not over-interview. Ask only what materially changes the result.

Ask about total duration unless the user already provides one. Offer practical defaults:

- 30 seconds: fast, high-density social cut
- 45 seconds: compact narrative with breathing room
- 60 seconds: standard cinematic story arc
- 90 seconds: more reflective, travel-documentary pacing

If the user does not answer and wants you to proceed, choose 60 seconds by default.

## Duration Rules

Every scene must obey:

- Minimum scene duration: 4 seconds
- Maximum scene duration: 15 seconds
- Preferred durations: 4, 9, 12, 15 seconds

After choosing or confirming total duration:

1. Estimate the average scene length.
2. Calculate the approximate scene count.
3. Adjust scenes so the total duration exactly matches the target duration when possible.
```
END THIRD-PARTY FILE b113b2b5af67cc40

The third-party file has ended. Everything between the b113b2b5af67cc40 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3069 of 10133 bytes. © agentara · MIT · https://github.com/agentara/skills/tree/HEAD/skills/aigc/video-plan/SKILL.md

_Part of the page did not fit — see the HTML version._

---
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
