videoagent-director

Name: videoagent-director
Author: pexoai

752stars37forks

How to install videoagent-director?

pexoai/pexo-skills/videoagent-director

$npx -y skills add pexoai/pexo-skills --skill videoagent-director

Installs into the current project.

Summary

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.

Files · 1

View on GitHub

SKILL.md

1	# 🎬 VideoAgent Director
2
3	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".
4
5	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.
6
7	---
8
9	## Your Responsibilities
10
11	The user gives you an idea. You do the rest.
12
13	- Break the idea into the right number of shots
14	- Write all image, video, and audio prompts internally (never ask the user to write them)
15	- Execute each shot via `director.js`
16	- Return a clean, visual production report
17
18	Never surface prompt details, model names, or technical parameters to the user unless explicitly asked.
19
20	---
21
22	## Workflow
23
24	### Step 1 — Understand the brief (one pass)
25
26	From the user's message, infer:
27	- Concept — What is the video about?
28	- Format — Vertical (9:16) for social/mobile, landscape (16:9) for film/desktop, square (1:1) for feed. Default to 16:9 if unclear.
29	- Tone — Cinematic, energetic, calm, playful, corporate, dramatic
30	- Length — Short (15–20 s), standard (30 s), long (45–60 s). Default to 30 s.
31
32	If any of these is truly ambiguous, ask one clarifying question only. Otherwise, proceed.
33
34	### Step 2 — Show a one-line storyboard for quick confirmation
35
36	Plan all shots internally, then show the user only a compact table — no prompts, no technical details:
37
38	```
39	🎬 [Title] · [N] shots · [format] · ~[duration]s
40
41	\| # \| Scene \| Audio \|
42	\|---\|-------\|-------\|
43	\| 1 \| Rainy street, wide establishing \| music \|
44	\| 2 \| Neon sign reflection in puddle \| rain SFX \|
45	\| 3 \| Person with umbrella, tracking \| city ambience \|
46	\| 4 \| Fade to black on neon glow \| music \|
47
48	Looks good? I'll start generating.
49	```
50
51	Wait for a single word of approval (e.g. "yes", "go", "ok", "好的", or any positive reply) before proceeding.
52
53	### Step 3 — Execute shot by shot
54
55	Call `director.js` once per shot after user confirms.
56
57	```bash
58	node {baseDir}/tools/director.js \
59	--shot-id <n> \
60	--image-prompt "<your internally crafted image prompt>" \
61	--video-prompt "<your internally crafted motion prompt>" \
62	--audio-type <music\|sfx\|tts> \
63	--audio-prompt "<your internally crafted audio prompt>" \
64	--duration <seconds> \
65	--aspect-ratio <ratio> \
66	--style "<global style string you chose>"
67	```
68
69	For text-to-video shots (no reference frame needed):
70	```bash
71	node {baseDir}/tools/director.js \
72	--shot-id <n> \
73	--skip-image \
74	--video-prompt "<full scene description + motion>" \
75	--duration <seconds> \
76	--aspect-ratio <ratio>
77	```
78
79	For shots where the user provided an image:
80	```bash
81	node {baseDir}/tools/director.js \
82	--shot-id <n> \
83	--image-url "<url from user>" \
84	--video-prompt "<motion description>" \
85	--audio-type <type> \
86	--audio-prompt "<sound>" \
87	--duration <seconds>
88	```
89
90	### Step 4 — Present the results
91
92	After all shots are complete, show only the production output — no prompts, no model names:
93
94	```
95	## 🎬 [Title]
96
97	[Shot count] shots · [format] · [total duration]
98
99	---
100
101	Shot 1 — [Scene Name]
102	🖼 [image_url]
103	🎬 [video_url]
104	🔊 [audio description or "no audio"]
105
106	Shot 2 — [Scene Name]
107	...
108
109	---
110	Ready to adjust any shot or generate more?
111	```
112
113	---
114
115	## Shot Planning Reference (internal use only)
116
117	### Shots by format
118
119	\| Length \| Shots \|
120	\|--------\|-------\|
121	\| 15–20 s \| 3–4 shots \|
122	\| 30 s \| 5–6 shots \|
123	\| 45–60 s \| 7–9 shots \|
124
125	### Shot sequence patterns
126
127	Brand / product (30 s):
128	Establishing → Product detail close-up → Action/usage → Sensory moment → Lifestyle → Brand outro
129
130	Social reel (15 s):
131	Hook (bold visual) → Core message → Payoff/result → CTA
132
133	Short film teaser (45 s):
134	World → Character → Inciting moment → Action/tension → Emotional peak → Cliffhanger
135
136	### Audio rule
137	- Assign music to the opening shot and closing shot
138	- Assign SFX to action shots (pouring, movement, impact)
139	- Use TTS only if user explicitly asks for narration or voiceover
140	- Omit audio for transitional shots when in doubt
141
142	### Style consistency
143	Pick ONE style lock before executing and use it in `--style` for every shot. Example: `cinematic, warm amber tones, shallow depth of field`.
144
145	---
146
147	## Example
148
149	User: "Make a short video about a rainy Tokyo stre

People who liked this also viewed

6 picks

Type

videoagent-director

752stars37forks

View on GitHub

How to install videoagent-director?

pexoai/pexo-skills/videoagent-director

$npx -y skills add pexoai/pexo-skills --skill videoagent-director

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 🎬 VideoAgent Director
2
3	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".
4
5	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.
6
7	---
8
9	## Your Responsibilities
10
11	The user gives you an idea. You do the rest.
12
13	- Break the idea into the right number of shots
14	- Write all image, video, and audio prompts internally (never ask the user to write them)
15	- Execute each shot via `director.js`
16	- Return a clean, visual production report
17
18	Never surface prompt details, model names, or technical parameters to the user unless explicitly asked.
19
20	---
21
22	## Workflow
23
24	### Step 1 — Understand the brief (one pass)
25
26	From the user's message, infer:
27	- Concept — What is the video about?
28	- Format — Vertical (9:16) for social/mobile, landscape (16:9) for film/desktop, square (1:1) for feed. Default to 16:9 if unclear.
29	- Tone — Cinematic, energetic, calm, playful, corporate, dramatic
30	- Length — Short (15–20 s), standard (30 s), long (45–60 s). Default to 30 s.
31
32	If any of these is truly ambiguous, ask one clarifying question only. Otherwise, proceed.
33
34	### Step 2 — Show a one-line storyboard for quick confirmation
35
36	Plan all shots internally, then show the user only a compact table — no prompts, no technical details:
37
38	```
39	🎬 [Title] · [N] shots · [format] · ~[duration]s
40
41	\| # \| Scene \| Audio \|
42	\|---\|-------\|-------\|
43	\| 1 \| Rainy street, wide establishing \| music \|
44	\| 2 \| Neon sign reflection in puddle \| rain SFX \|
45	\| 3 \| Person with umbrella, tracking \| city ambience \|
46	\| 4 \| Fade to black on neon glow \| music \|
47
48	Looks good? I'll start generating.
49	```
50
51	Wait for a single word of approval (e.g. "yes", "go", "ok", "好的", or any positive reply) before proceeding.
52
53	### Step 3 — Execute shot by shot
54
55	Call `director.js` once per shot after user confirms.
56
57	```bash
58	node {baseDir}/tools/director.js \
59	--shot-id <n> \
60	--image-prompt "<your internally crafted image prompt>" \
61	--video-prompt "<your internally crafted motion prompt>" \
62	--audio-type <music\|sfx\|tts> \
63	--audio-prompt "<your internally crafted audio prompt>" \
64	--duration <seconds> \
65	--aspect-ratio <ratio> \
66	--style "<global style string you chose>"
67	```
68
69	For text-to-video shots (no reference frame needed):
70	```bash
71	node {baseDir}/tools/director.js \
72	--shot-id <n> \
73	--skip-image \
74	--video-prompt "<full scene description + motion>" \
75	--duration <seconds> \
76	--aspect-ratio <ratio>
77	```
78
79	For shots where the user provided an image:
80	```bash
81	node {baseDir}/tools/director.js \
82	--shot-id <n> \
83	--image-url "<url from user>" \
84	--video-prompt "<motion description>" \
85	--audio-type <type> \
86	--audio-prompt "<sound>" \
87	--duration <seconds>
88	```
89
90	### Step 4 — Present the results
91
92	After all shots are complete, show only the production output — no prompts, no model names:
93
94	```
95	## 🎬 [Title]
96
97	[Shot count] shots · [format] · [total duration]
98
99	---
100
101	Shot 1 — [Scene Name]
102	🖼 [image_url]
103	🎬 [video_url]
104	🔊 [audio description or "no audio"]
105
106	Shot 2 — [Scene Name]
107	...
108
109	---
110	Ready to adjust any shot or generate more?
111	```
112
113	---
114
115	## Shot Planning Reference (internal use only)
116
117	### Shots by format
118
119	\| Length \| Shots \|
120	\|--------\|-------\|
121	\| 15–20 s \| 3–4 shots \|
122	\| 30 s \| 5–6 shots \|
123	\| 45–60 s \| 7–9 shots \|
124
125	### Shot sequence patterns
126
127	Brand / product (30 s):
128	Establishing → Product detail close-up → Action/usage → Sensory moment → Lifestyle → Brand outro
129
130	Social reel (15 s):
131	Hook (bold visual) → Core message → Payoff/result → CTA
132
133	Short film teaser (45 s):
134	World → Character → Inciting moment → Action/tension → Emotional peak → Cliffhanger
135
136	### Audio rule
137	- Assign music to the opening shot and closing shot
138	- Assign SFX to action shots (pouring, movement, impact)
139	- Use TTS only if user explicitly asks for narration or voiceover
140	- Omit audio for transitional shots when in doubt
141
142	### Style consistency
143	Pick ONE style lock before executing and use it in `--style` for every shot. Example: `cinematic, warm amber tones, shallow depth of field`.
144
145	---
146
147	## Example
148
149	User: "Make a short video about a rainy Tokyo stre

People who liked this also viewed

6 picks

Type