Agent skill

Videoagent Director

AI creative director that turns a user's natural-language idea into a complete storyboard and generates all assets — images, video clips, and audio — automatically.

MITAuto-check passedMedia & Creative

Install Videoagent Director

skills CLI

$ npx skills add pexoai/pexo-skills --skill videoagent-director -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install pexoai/pexo-skills videoagent-director --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/pexoai/pexo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/videoagent-director .claude/skills/videoagent-director && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "videoagent-director" agent skill from https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director into .claude/skills/videoagent-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "videoagent-director", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add pexoai/pexo-skills --skill videoagent-director -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install pexoai/pexo-skills videoagent-director --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/pexoai/pexo-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/videoagent-director .agents/skills/videoagent-director && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "videoagent-director" agent skill from https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director into .agents/skills/videoagent-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "videoagent-director", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add pexoai/pexo-skills --skill videoagent-director -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install pexoai/pexo-skills videoagent-director --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/pexoai/pexo-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/videoagent-director .cursor/skills/videoagent-director && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "videoagent-director" agent skill from https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director into .cursor/skills/videoagent-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "videoagent-director", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/pexoai/pexo-skills.git --path skills/videoagent-director

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add pexoai/pexo-skills --skill videoagent-director -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install pexoai/pexo-skills videoagent-director --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/pexoai/pexo-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/videoagent-director .gemini/skills/videoagent-director && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "videoagent-director" agent skill from https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director into .gemini/skills/videoagent-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "videoagent-director", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install pexoai/pexo-skills videoagent-director

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add pexoai/pexo-skills --skill videoagent-director -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/pexoai/pexo-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/videoagent-director .github/skills/videoagent-director && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "videoagent-director" agent skill from https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director into .github/skills/videoagent-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "videoagent-director", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add pexoai/pexo-skills --skill videoagent-director -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install pexoai/pexo-skills videoagent-director --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/pexoai/pexo-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/videoagent-director .opencode/skills/videoagent-director && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "videoagent-director" agent skill from https://github.com/pexoai/pexo-skills/tree/main/skills/videoagent-director into .opencode/skills/videoagent-director/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "videoagent-director", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: videoagent-director
GitHub stars: 804
Token cost: ~1.3k tokens
SKILL.md length: 496 words
Files: 5 (incl. references)
Skills in repo: 18
Repo updated: Aug 20, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

AI creative director that turns a user's natural-language idea into a complete storyboard and generates all assets — images, video clips, and audio — automatically.

Works in 4 steps: Understand the brief (one pass) → Show a one-line storyboard for quick… → Execute shot by shot → …
Tasks that involve Comics and storyboards
SKILL.md covers Your Responsibilities, Workflow, Shot Planning Reference… and Example
Runs JavaScript scripts from its folder; calls node

What it does

Videoagent Director is an agent skill from pexoai/pexo-skills. AI creative director that turns a user's natural-language idea into a complete storyboard and generates all assets — images, video clips, and audio — automatically. The user only describes what they want; all prompt engineering is handled internally.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `README.md`, `package.json` and `references/storyboard_guide.md`).

It sits in Media & Creative, covering Comics and storyboards and Video production. The repository describes itself as: A collection of open-source Agent Skills for content creation — images, audio, and video. The licence is MIT.

When your agent uses it

Tasks that involve Comics and storyboards
Tasks that involve Video production

Example prompts

“/videoagent-director”

Requirements

Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Understand the brief (one pass)
Show a one-line storyboard for quick confirmation
Execute shot by shot
Present the results

What it can do on your machine

Read from SKILL.md and the folder at commit f724267. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
- node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Videoagent Director loads about 1.3k tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 496 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~68
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pexoai/pexo-skills at commit f724267, republished under its MIT licence (© pexoai). 496 words, ~1,344 tokens.

Download SKILL.mdSave it as .claude/skills/videoagent-director/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: videoagent-director
description: AI creative director that turns a user's natural-language idea into a complete storyboard and generates all assets — images, video clips, and audio — automatically. The user only describes what they want; all prompt engineering is handled internally.
version: 1.1.0
author: pexoai
emoji: 🎬
tags: director, storyboard, video-production, image-to-video, multi-modal, orchestration

🎬 VideoAgent Director

Use when: The user wants to produce a video from a natural-language idea — a brand video, short film, social reel, product ad, or any creative concept. Also use for "make a storyboard", "create a scene breakdown", or "produce a short clip about X".

You are the creative director. The user describes what they want. You handle everything — shot planning, prompt writing, asset generation — without asking the user to write any prompts.

Your Responsibilities

The user gives you an idea. You do the rest.

Break the idea into the right number of shots
Write all image, video, and audio prompts internally (never ask the user to write them)
Execute each shot via director.js
Return a clean, visual production report

Never surface prompt details, model names, or technical parameters to the user unless explicitly asked.

Workflow

Step 1 — Understand the brief (one pass)

From the user's message, infer:

Concept — What is the video about?
Format — Vertical (9:16) for social/mobile, landscape (16:9) for film/desktop, square (1:1) for feed. Default to 16:9 if unclear.
Tone — Cinematic, energetic, calm, playful, corporate, dramatic
Length — Short (15–20 s), standard (30 s), long (45–60 s). Default to 30 s.

If any of these is truly ambiguous, ask one clarifying question only. Otherwise, proceed.

Step 2 — Show a one-line storyboard for quick confirmation

Plan all shots internally, then show the user only a compact table — no prompts, no technical details:

🎬 **[Title]** · [N] shots · [format] · ~[duration]s

| # | Scene | Audio |
|---|-------|-------|
| 1 | Rainy street, wide establishing | music |
| 2 | Neon sign reflection in puddle | rain SFX |
| 3 | Person with umbrella, tracking | city ambience |
| 4 | Fade to black on neon glow | music |

Looks good? I'll start generating.

Wait for a single word of approval (e.g. "yes", "go", "ok", "好的", or any positive reply) before proceeding.

Step 3 — Execute shot by shot

Call director.js once per shot after user confirms.

bash

node {baseDir}/tools/director.js \
  --shot-id <n> \
  --image-prompt "<your internally crafted image prompt>" \
  --video-prompt "<your internally crafted motion prompt>" \
  --audio-type <music|sfx|tts> \
  --audio-prompt "<your internally crafted audio prompt>" \
  --duration <seconds> \
  --aspect-ratio <ratio> \
  --style "<global style string you chose>"

For text-to-video shots (no reference frame needed):

bash

node {baseDir}/tools/director.js \
  --shot-id <n> \
  --skip-image \
  --video-prompt "<full scene description + motion>" \
  --duration <seconds> \
  --aspect-ratio <ratio>

For shots where the user provided an image:

bash

node {baseDir}/tools/director.js \
  --shot-id <n> \
  --image-url "<url from user>" \
  --video-prompt "<motion description>" \
  --audio-type <type> \
  --audio-prompt "<sound>" \
  --duration <seconds>

Step 4 — Present the results

After all shots are complete, show only the production output — no prompts, no model names:

## 🎬 [Title]

**[Shot count] shots · [format] · [total duration]**

---

**Shot 1 — [Scene Name]**
🖼 [image_url]
🎬 [video_url]
🔊 [audio description or "no audio"]

**Shot 2 — [Scene Name]**
...

---
Ready to adjust any shot or generate more?

Show full SKILL.md (196 more words)Show less

Shot Planning Reference (internal use only)

Shots by format

Length	Shots
15–20 s	3–4 shots
30 s	5–6 shots
45–60 s	7–9 shots

Shot sequence patterns

Brand / product (30 s): Establishing → Product detail close-up → Action/usage → Sensory moment → Lifestyle → Brand outro

Social reel (15 s): Hook (bold visual) → Core message → Payoff/result → CTA

Short film teaser (45 s): World → Character → Inciting moment → Action/tension → Emotional peak → Cliffhanger

Audio rule

Assign music to the opening shot and closing shot
Assign SFX to action shots (pouring, movement, impact)
Use TTS only if user explicitly asks for narration or voiceover
Omit audio for transitional shots when in doubt

Style consistency

Pick ONE style lock before executing and use it in --style for every shot. Example: cinematic, warm amber tones, shallow depth of field.

Example

User: "Make a short video about a rainy Tokyo street at night."

You internally plan:

4 shots · 16:9 · ~20 s
Style: cinematic, neon-wet streets, shallow depth of field, rain
Shot 1: wide establishing (music), Shot 2: close-up puddle reflection (SFX rain), Shot 3: person with umbrella tracking (SFX city ambience), Shot 4: neon sign fade-out (music outro)

Then execute all 4 shots silently and show only the results.

Files

SKILL.md and 4 other files (references) in skills/videoagent-director of pexoai/pexo-skills.

SKILL.md
README.md
package.json
references/storyboard_guide.md
tools/director.js

Open the folder on GitHubat commit f724267

Compare with similar skills

Videoagent Director next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Videoagent Director compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Videoagent Director this skillpexoai/pexo-skills	804	—	~1.3k	Automated safety check: Pass	MIT	1 mo ago
Scroll Promo Site Builderkangarooking/kangarooking-skills	662	—	~2.6k	Automated safety check: Pass	MIT	1 mo ago
Paper Collage Explainer Generatortl2012tl/comfyUI-llama-TE	241	4 repos	~5.2k	Automated safety check: Pass	None	18 days ago
Video ComposeUtopai-Research/pai-code	357	—	~4.1k	Automated safety check: Pass	Custom licence	10 days ago
Ffmpegrendi-api/ffmpeg-cheatsheet	1.7k	—	~1.2k	Automated safety check: Pass	None	5 mo ago
Remotion VideoTechNomadCode/AI-Product-Development-Toolkit	1k	—	~1.1k	Automated safety check: Pass	MIT	4 days ago

Similar skills

Scroll Promo Site Builder
kangarooking/kangarooking-skills
Create a scroll-controlled cinematic product website with rich motion (动效网站) from product materials, reference pages or videos, and brand assets.
662 GitHub stars~2.6k tokensUpdated 1 mo ago
Media & CreativeAuto-check passed
Paper Collage Explainer Generator
tl2012tl/comfyUI-llama-TE
For creators, educators, and social-video editors who need a tactile paper-collage language for narration, knowledge points, opinions, or abstract topics.
241 GitHub starsUsed in 4 repos~5.2k tokens
Media & CreativeAuto-check passed
Video Compose
Utopai-Research/pai-code
Generates and prompts video clips on the filmmaking canvas. An agent skill from Utopai-Research/pai-code.
357 GitHub stars~4.1k tokensUpdated 10 days ago
Media & CreativeAuto-check passed
Ffmpeg
rendi-api/ffmpeg-cheatsheet
A skill your agent uses when the user asks for FFmpeg or FFprobe commands, video/audio conversion, trimming, resizing, padding, overlays, subtitles, thumbnails, GIFs, storyboards, slideshows…
1.7k GitHub stars~1.2k tokensUpdated 5 mo ago
Media & CreativeAuto-check passed
Remotion Video
TechNomadCode/AI-Product-Development-Toolkit
Make a short video about a product or brand (promo, launch, explainer, demo or social clip) entirely in code with Remotion, from idea to a rendered MP4 with sound.
1k GitHub stars~1.1k tokensUpdated 4 days ago
Media & CreativeAuto-check passed
Video Plan
MagicCube/agentara
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…
516 GitHub starsUsed in 1 repo~2.6k tokens
Media & CreativeAuto-check passed

Questions about Videoagent Director

What does Videoagent Director do?

AI creative director that turns a user's natural-language idea into a complete storyboard and generates all assets — images, video clips, and audio — automatically. Videoagent Director is an agent skill from pexoai/pexo-skills. AI creative director that turns a user's natural-language idea into a complete storyboard and generates all assets — images, video clips, and audio — automatically.

When should I use Videoagent Director?

Videoagent Director fits situations like: tasks that involve Comics and storyboards; tasks that involve Video production.

How do I install Videoagent Director in Claude Code?

Run `npx skills add pexoai/pexo-skills --skill videoagent-director -a claude-code`. Or copy the skill folder (skills/videoagent-director in pexoai/pexo-skills) into .claude/skills/videoagent-director in your project. Claude Code loads it when a task matches its description.

How do I install Videoagent Director in Codex?

Run `npx skills add pexoai/pexo-skills --skill videoagent-director -a codex`. Or copy the skill folder (skills/videoagent-director in pexoai/pexo-skills) into .agents/skills/videoagent-director in your project. Codex loads it when a task matches its description.

Can I use Videoagent Director in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pexoai/pexo-skills --skill videoagent-director -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/videoagent-director, .gemini/skills/videoagent-director, .github/skills/videoagent-director and .opencode/skills/videoagent-director in your project.

What does Videoagent Director need to run?

Going by SKILL.md and its folder, Videoagent Director needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.

Does Videoagent Director access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Videoagent Director safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Videoagent Director use?

Videoagent Director is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Videoagent Director use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Videoagent Director?

Skills that share tags, products or a category with Videoagent Director: Scroll Promo Site Builder (kangarooking/kangarooking-skills, 662 stars), Paper Collage Explainer Generator (tl2012tl/comfyUI-llama-TE, 241 stars), Video Compose (Utopai-Research/pai-code, 357 stars) and Ffmpeg (rendi-api/ffmpeg-cheatsheet, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Videoagent Director?

pexoai (a GitHub user) maintains it in pexoai/pexo-skills, which has 804 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on August 20, 2026.

Source: pexoai/pexo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Videoagent Director

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

🎬 VideoAgent Director

Your Responsibilities

Workflow

Step 1 — Understand the brief (one pass)

Step 2 — Show a one-line storyboard for quick confirmation

Step 3 — Execute shot by shot

Step 4 — Present the results

Shot Planning Reference (internal use only)

Shots by format

Shot sequence patterns

Audio rule

Style consistency

Example

Files

Compare with similar skills

Similar skills

More from pexoai/pexo-skills

Related

Questions about Videoagent Director