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. The user only describes what they want; all prompt engineering is handled internally.
- Installs
- 542
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/pexoai/pexo-skills --skill videoagent-director- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads videoagent-director automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
🎬 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.
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):
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:
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?
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.
FAQ
What does the videoagent-director skill 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. The user only describes what they want; all prompt engineering is handled internally.
How do I install videoagent-director?
Run npx skills add https://github.com/pexoai/pexo-skills --skill videoagent-director in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/videoagent-director/ (personal) or .claude/skills/videoagent-director/ (project).
Which AI agents can use videoagent-director?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is videoagent-director safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains videoagent-director?
It is published by pexoai in pexoai/pexo-skills. It has 542 recorded installs.
More from pexoai/pexo-skills
pexo-agent
pexoai/pexo-skills
AI video generation skill with auto model selection across Seedance 2, Kling 3.0, HappyHorse, and 10+ models. Produces finished multi-shot videos (5–120s) from text, images, URLs, scripts, or audio — including AI music, lip sync, and multi-shot sequencing. Calls Pexo's external API, manages project status and billing confirmations, and transfers only user-approved briefs and assets. Runs setup diagnostics, stores generated downloads locally, and requires shell, outbound HTTPS, and local file access. Authenticated requests are locked to https://pexo.ai. No prompts to write, no models to choose. USE FOR: video production, AI video, make a video, product video, brand video, promotional clip, explainer video, short video, TikTok video, Instagram Reel, YouTube Short, product ad, text-to-video, image-to-video, video generation, AI video agent.
videoagent-video-studio
pexoai/pexo-skills
Generate short AI videos from text or images — text-to-video, image-to-video, and reference-based generation — with zero API key setup. Use when the user wants to create a video clip, animate an image, or generate video from a description.
videoagent-image-studio
pexoai/pexo-skills
Tired of juggling 8 API keys? This skill gives you one-command access to Midjourney, Flux, Ideogram, and more, with zero setup. Use when you want to generate any image without worrying about API keys.
videoagent-audio-studio
pexoai/pexo-skills
Tired of juggling multiple audio APIs? This skill gives you one-command access to TTS, music generation, sound effects, and voice cloning. Use when you want to generate any audio without managing multiple API keys.
seedance-2.0-prompter
pexoai/pexo-skills
Expert prompt engineering for Seedance 2.0. Use when the user wants to generate a video with multimodal assets (images, videos, audio) and needs the best possible prompt.
veo-3.2-prompter
pexoai/pexo-skills
Expert prompt engineering for Google Veo 3.2 (Artemis engine). Use when the user wants to generate a video with Veo 3.2, needs help crafting cinematic prompts, or mentions Veo, Google video generation, or Artemis engine.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image