muapi-social-media-video

Brand-aware social media video creator.

Paste into Claude, ChatGPT or Cursor.

Read the source277 lines

muapi-social-media-video /

SKILL.md only. Everything else in the repo is on GitHub.

muapi-social-media-video/SKILL.md277 lines11.2 KBpushed 100d agoRawView on GitHub

1	---
2	slug: muapi-social-media-video
3	name: muapi-social-media-video
4	version: "1.0.0"
5	description: Brand-aware social media video creator. Reads brand-identity.md, ICP.md, and messaging.md to write a post/storyboard, craft an optimized Seedance 2.0 Director prompt, generate reference frames with the best available image model, and produce platform-ready video.
6	acceptLicenseTerms: true
7	---
8
9	# Social Media Video Creator
10
11	End-to-end pipeline: Brand Files → Storyboard → Reference Images → Seedance 2.0 Video.
12
13	Reads your brand identity, ICP, and messaging documents to produce on-brand social video — fully optimized for Seedance 2.0's instructional prompt grammar and your target platform.
14
15	---
16
17	## Agent Execution Protocol
18
19	### Step 1 — Read Brand Files
20
21	Before writing anything, the agent MUST read all available brand files. Look for them in the working directory or any `brand/` subdirectory:
22
23	\| File \| What to extract \|
24	\|:---\|:---\|
25	\| `brand-identity.md` \| Visual style, color palette, tone, logo/product aesthetics, brand personality \|
26	\| `ICP.md` \| Target audience — who they are, their pain points, what motivates them \|
27	\| `messaging.md` \| Core value props, hooks, CTAs, campaign themes, taglines \|
28
29	If a file is missing, proceed with what's available and note the gap.
30
31	---
32
33	### Step 2 — Write the Social Post + Storyboard
34
35	Use brand context to produce:
36
37	Social Post Copy (for caption/copy):
38	- Hook line (first 1–2 sentences — must stop the scroll)
39	- Body (3–5 sentences: problem → solution → proof → CTA)
40	- Hashtags (5–8 relevant tags)
41	- CTA (one clear action)
42
43	Storyboard (match duration to platform spec):
44	```
45	0–3s: [Opening scene — hook/visual surprise — camera move]
46	3–7s: [Core message — product/subject in action — camera move]
47	7–10s: [Resolution — brand moment — CTA text on screen]
48	10–15s: [Logo/tagline hold — background music fade]
49	```
50
51	Tone must match brand personality. If brand is playful → upbeat transitions, bright grade.
52	If brand is premium → slow reveals, dark luxury aesthetic, moody lighting.
53
54	---
55
56	### Step 3 — Craft the Seedance 2.0 Director Prompt
57
58	Transform the storyboard into a technical Director Brief for Seedance 2.0.
59
60	Rules:
61	1. Never use vague descriptors ("beautiful", "amazing", "8k"). Use technical cinematography language.
62	2. Always specify camera movement, lens type, and lighting physically.
63	3. For 10s+ videos, use timecode segments: `0–3s: [...] 3–7s: [...] 7–10s: [...]`
64	4. Integrate `@image1`, `@image2` reference tags if images are provided.
65	5. Always include sound direction (even brief) — Seedance generates audio.
66	6. Lead with composition, end with texture and micro-motion.
67
68	Director Brief Template:
69	```
70	[SCENE] {environment, lighting, time of day}
71	[SUBJECT] {product/character/subject with specific detail}
72	[ACTION] {what happens — fluid, continuous, physically plausible}
73	[CAMERA] {movement + lens + framing}
74	[STYLE] {color grade, mood, film reference if helpful}
75	[SOUND] {music tone, sound effects, ambient}
76	0–Xs: {if multi-beat}
77	```
78
79	---
80
81	### Step 4 — Generate Reference Images (If Needed)
82
83	When to generate reference images:
84
85	\| Scenario \| Mode \| Images Needed \|
86	\|:---\|:---\|:---\|
87	\| Product showcase \| `i2v` \| 1 product shot as first frame \|
88	\| Scene transition \| `first-last` \| 2 images — opening and closing frame \|
89	\| Brand character \| `i2v` \| 1 character reference \|
90	\| Pure concept \| `t2v` \| None — text only \|
91	\| Mood/style anchor \| `i2v` \| 1 style reference image \|
92
93	Image generation — best models by use case:
94
95	\| Use Case \| Recommended Model \| Why \|
96	\|:---\|:---\|:---\|
97	\| Photorealistic product/scene \| `google-imagen4-ultra` \| Highest realism, great lighting \|
98	\| Concept art / stylized \| `flux-kontext-pro-t2i` \| Creative fidelity, style adherence \|
99	\| Fastest turnaround \| `google-imagen4-fast` \| Speed with good quality \|
100	\| Highly detailed/editorial \| `hidream-i1-full` \| Fine detail, editorial quality \|
101	\| Character with identity \| `ideogram-v3-t2i` \| Strong text + character rendering \|
102
103	Reference image prompt format:
104	Write a clean, technical image prompt (not a Seedance prompt). Include:
105	- Subject description + key product/brand visual elements
106	- Lighting (studio, golden hour, etc.)
107	- Shot framing (medium shot, product close-up, etc.)
108	- Mood/color palette matching brand identity
109	- NO motion language (this is for a still frame)
110
111	Execute image generation:
112	```bash
113	bash core/media/generate-image.sh \
114	--model google-imagen4-ultra \
115	--prompt "your image prompt" \
116	--aspect-ratio 9:16 \
117	--view
118	```
119
120	---
121
122	### Step 5 — Generate the Video
123
124	Choose mode, tier, and camera based on content type and available assets.
125
126	Mode selection:
127
128	\| Situation \| Mode \| Command \|
129	\|:---\|:---\|:---\|
130	\| No reference images \| `t2v` \| default \|
131	\| 1 image (first frame) \| `i2v` \| `--mode i2v --file ref.jpg` \|
132	\| Start + end frames \| `first-last` \| `--mode first-last --tier global --file start.jpg --file end.jpg` \|
133	\| Multi-ref blend \| `i2v` \| up to 9 images \|
134
135	Invoke the script:
136	```bash
137	bash library/social/social-media-video/scripts/run-social-video.sh \
138	--prompt "your director brief here" \
139	--platform instagram \
140	--camera drone \
141	[--mode t2v\|i2v\|first-last] \
142	[--file ref_image.jpg] \
143	[--gen-ref "reference image prompt"] \
144	[--tier global] \
145	[--quality high] \
146	[--view]
147	```
148
149	---
150
151	## Platform Specs
152
153	\| Platform \| Format \| Aspect \| Duration \| Notes \|
154	\|:---\|:---\|:---\|:---\|:---\|
155	\| Instagram Reels \| Vertical \| 9:16 \| 10–15s \| Hook in first 1s \|
156	\| Instagram Feed \| Square \| 1:1 \| 10s \| Static-feel works well \|
157	\| TikTok \| Vertical \| 9:16 \| 10–15s \| High energy, fast cuts \|
158	\| YouTube Shorts \| Vertical \| 9:16 \| 15s \| Max quality \|
159	\| LinkedIn \| Landscape \| 16:9 \| 10–15s \| Professional tone \|
160	\| Twitter/X \| Landscape \| 16:9 \| 10s \| Punchy, direct \|
161	\| YouTube (long) \| Landscape \| 16:9 \| 15s \| Cinematic, slow builds \|
162	\| Pinterest \| Portrait \| 4:3 \| 10s \| Lifestyle-forward \|
163
164	> Tier note: Use `--tier global` or `--tier vip` for `1:1` and `21:9` formats. Chinese tier supports only 16:9, 9:16, 4:3, 3:4.
165
166	---
167
168	## Camera Language Reference
169
170	### Standard Camera Intents (--camera / --intent flags)
171
172	\| Intent \| Movement \| Best For \|
173	\|:---\|:---\|:---\|
174	\| `reveal` \| Slow crane up, wide establishing \| Product launches, brand reveals \|
175	\| `epic` \| Dolly in + orbit, low hero angle \| Brand manifesto, emotional story \|
176	\| `product` \| Static macro orbit, precision reveal \| E-commerce, product demo \|
177	\| `narrative` \| Tracking shot, Steadicam \| Testimonials, story-driven \|
178	\| `tense` \| Handheld jitter, dutch angle \| High-energy, urgency \|
179	\| `comedy` \| Reactive handheld, punchy zooms \| Lighthearted brand content \|
180
181	### Specialty Camera Intents (New)
182
183	\| Intent \| Description \| Best For \|
184	\|:---\|:---\|:---\|
185	\| `fpv` \| First-person subjective POV — immersive GoPro-style, continuous forward motion, peripheral detail close-ups \| Action brands, travel, sports, tech demos \|
186	\| `drone` \| Aerial cinematic flythrough — smooth gimbal-stabilized, sweeping laterals, descend from high altitude into scene \| Real estate, luxury, outdoor brands, epic reveals \|
187	\| `flythrough` \| Ground-level architectural flythrough — continuous dolly through space, seamless portal transitions \| Architecture, interior design, venue showcases \|
188
189	FPV Prompt Enrichment:
190	```
191	Immersive first-person POV shot. Camera glides forward through [scene] at eye level.
192	Slight natural motion stabilization with GoPro-style wide angle.
193	Peripheral detail rushing past — [details]. Smooth continuous forward motion.
194	No cuts throughout. [Subject] visible in foreground periphery.
195	```
196
197	Drone Flythrough Prompt Enrichment:
198	```
199	Cinematic aerial drone shot. Camera descends from 200m altitude toward [subject/scene],
200	sweeping lateral arc as it descends. Gimbal-stabilized smooth motion.
201	Golden hour atmosphere, long shadows across [terrain/scene].
202	Final frame settles into medium establishing shot.
203	Aerial cinematography, DJI Inspire aesthetic.
204	```
205
206	---
207
208	## Prompt Quality Checklist
209
210	Before finalizing the Seedance prompt, verify:
211
212	- [ ] Scene environment is physically specific (not "nice background")
213	- [ ] Camera movement named explicitly (dolly in, orbit, drone flythrough, FPV, etc.)
214	- [ ] Lighting described technically (volumetric god rays, rim lighting, soft diffused, etc.)
215	- [ ] Subject/product described with visual specifics from brand-identity.md
216	- [ ] Sound direction included (even one line)
217	- [ ] Timecodes used for 10s+ videos
218	- [ ] `@image1` etc. referenced if images are provided
219	- [ ] Brand CTA or tagline included in final seconds
220	- [ ] No vague adjectives ("amazing", "beautiful", "stunning") — replaced with technical terms
221
222	---
223
224	## Example: Full Workflow
225
226	User: "Make an Instagram Reel for our cold brew coffee brand, drone shot, premium feel"
227
228	Step 1 — Brand read: Read `brand-identity.md` (minimalist packaging, dark roast, black + gold palette), `ICP.md` (urban professionals 25–40, values quality), `messaging.md` ("Precision Brewed. Zero Compromise.")
229
230	Step 2 — Storyboard:
231	```
232	0–2s: Drone descends over rooftop terrace at sunrise, fog below.
233	2–5s: Drone swoops down toward coffee cup on white marble, steam rising.
234	5–9s: Close-up orbit of bottle, specular gold highlights, ice cubes.
235	9–11s: Product settles, black screen fades in: "Zero Compromise." + logo
236	Sound: Minimal lounge beat, coffee pour sound effect at 5s.
237	```
238
239	Step 3 — Seedance Director Prompt:
240	```
241	0–2s: Cinematic aerial drone shot. Camera descends at 30° angle toward a rooftop terrace at sunrise.
242	Golden hour atmosphere, San Francisco bay fog below horizon. Gimbal-stabilized smooth descent.
243	2–5s: Drone rapidly closes toward a glass of cold brew coffee on white marble.
244	Steam curling upward. Macro lens approach. Caustic light patterns on wet glass surface.
245	5–9s: Slow precision orbit around cold brew bottle. Black matte label with gold embossed text catching
246	specular highlights. Ice cubes with subsurface light scattering. Commercial macro aesthetic.
247	9–11s: Static product hero shot. Letterbox crop, deep focus, black fade in from sides.
248	Sound: Minimal ambient beat, single piano note, coffee liquid sound effect at 5s mark.
249	Maintain cinematic color grade — deep blacks, warm gold midtones throughout.
250	```
251
252	Step 4 — Generate reference: `google-imagen4-ultra` → cold brew bottle product shot (9:16)
253
254	Step 5 — Generate video:
255	```bash
256	bash library/social/social-media-video/scripts/run-social-video.sh \
257	--prompt "0–2s: Cinematic aerial drone shot..." \
258	--platform instagram \
259	--camera drone \
260	--mode i2v \
261	--file media_outputs/coldbrew_ref.jpg \
262	--duration 11 \
263	--tier global \
264	--view
265	```
266
267	---
268
269	## Common Mistakes to Avoid
270
271	1. Reading brand files and ignoring them — the storyboard must visually match the brand palette and tone.
272	2. Generic prompts — "a nice video of a product" produces generic output. Every token must direct.
273	3. Wrong tier for aspect ratio — 1:1 and 21:9 require `--tier global` or `--tier vip`.
274	4. Forgetting sound — Seedance generates audio. Direct it, or you get random results.
275	5. FPV with static subject — FPV requires continuous motion in the scene. Pair with movement-rich environments.
276	6. Drone without establishing shot — drone works best when it resolves INTO something (a product, a scene, a subject).
277	7. Too many scene changes in 5s — match complexity to duration. 5s = 1 beat. 15s = 3–4 beats.

Discussion

Alternatives

Also in Photo styles

2026 Size Neler getirecekYüklenen ve Doğum bilgileri girilen görselin Astrolojik 2026 yılıImage Generation · CC0-1.0 A Half-Built Pyramid and the Leader Who Turned Labor Into LegacyA hyper realistic 4K cinematic visualization set in ancient Egypt, capturing the Great Pyramid mid construction. The pyramid stands half built, monumental yet incomplete, while massive stone blocks glide through engineered water canals on heavy rafts. Coordinated crews, ropes, ramps and wooden structures illustrate a sophisticated logistics system. Dust, mist and golden light create an epic sense of scale.Image Generation · CC0-1.0 A Moment Shared with the WildA candid, photorealistic iPhone-style selfie capturing a relaxed moment between a human and a wild {WILD_ANIMAL} in its natural habitat. Natural light, subtle motion, and authentic details create the feeling of a real, spontaneous encounter in the wild.Image Generation · CC0-1.0 A night in paris{ "subject_and_scene": { "main_subject": "A young man with thick curly brown hair, wearing a sophisticated beige turtleneck sweater and a matching tailored woolImage Generation · CC0-1.0