Generative-Media-Skills muapi-social-media-video
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.
git clone https://github.com/SamurAIGPT/Generative-Media-Skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/SamurAIGPT/Generative-Media-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/library/social/social-media-video" ~/.claude/skills/samuraigpt-generative-media-skills-muapi-social-media-video && rm -rf "$T"
library/social/social-media-video/SKILL.mdSocial Media Video Creator
End-to-end pipeline: Brand Files → Storyboard → Reference Images → Seedance 2.0 Video.
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.
Agent Execution Protocol
Step 1 — Read Brand Files
Before writing anything, the agent MUST read all available brand files. Look for them in the working directory or any
brand/ subdirectory:
| File | What to extract |
|---|---|
| Visual style, color palette, tone, logo/product aesthetics, brand personality |
| Target audience — who they are, their pain points, what motivates them |
| Core value props, hooks, CTAs, campaign themes, taglines |
If a file is missing, proceed with what's available and note the gap.
Step 2 — Write the Social Post + Storyboard
Use brand context to produce:
Social Post Copy (for caption/copy):
- Hook line (first 1–2 sentences — must stop the scroll)
- Body (3–5 sentences: problem → solution → proof → CTA)
- Hashtags (5–8 relevant tags)
- CTA (one clear action)
Storyboard (match duration to platform spec):
0–3s: [Opening scene — hook/visual surprise — camera move] 3–7s: [Core message — product/subject in action — camera move] 7–10s: [Resolution — brand moment — CTA text on screen] 10–15s: [Logo/tagline hold — background music fade]
Tone must match brand personality. If brand is playful → upbeat transitions, bright grade. If brand is premium → slow reveals, dark luxury aesthetic, moody lighting.
Step 3 — Craft the Seedance 2.0 Director Prompt
Transform the storyboard into a technical Director Brief for Seedance 2.0.
Rules:
- Never use vague descriptors ("beautiful", "amazing", "8k"). Use technical cinematography language.
- Always specify camera movement, lens type, and lighting physically.
- For 10s+ videos, use timecode segments:
0–3s: [...] 3–7s: [...] 7–10s: [...] - Integrate
,@image1
reference tags if images are provided.@image2 - Always include sound direction (even brief) — Seedance generates audio.
- Lead with composition, end with texture and micro-motion.
Director Brief Template:
[SCENE] {environment, lighting, time of day} [SUBJECT] {product/character/subject with specific detail} [ACTION] {what happens — fluid, continuous, physically plausible} [CAMERA] {movement + lens + framing} [STYLE] {color grade, mood, film reference if helpful} [SOUND] {music tone, sound effects, ambient} 0–Xs: {if multi-beat}
Step 4 — Generate Reference Images (If Needed)
When to generate reference images:
| Scenario | Mode | Images Needed |
|---|---|---|
| Product showcase | | 1 product shot as first frame |
| Scene transition | | 2 images — opening and closing frame |
| Brand character | | 1 character reference |
| Pure concept | | None — text only |
| Mood/style anchor | | 1 style reference image |
Image generation — best models by use case:
| Use Case | Recommended Model | Why |
|---|---|---|
| Photorealistic product/scene | | Highest realism, great lighting |
| Concept art / stylized | | Creative fidelity, style adherence |
| Fastest turnaround | | Speed with good quality |
| Highly detailed/editorial | | Fine detail, editorial quality |
| Character with identity | | Strong text + character rendering |
Reference image prompt format: Write a clean, technical image prompt (not a Seedance prompt). Include:
- Subject description + key product/brand visual elements
- Lighting (studio, golden hour, etc.)
- Shot framing (medium shot, product close-up, etc.)
- Mood/color palette matching brand identity
- NO motion language (this is for a still frame)
Execute image generation:
bash core/media/generate-image.sh \ --model google-imagen4-ultra \ --prompt "your image prompt" \ --aspect-ratio 9:16 \ --view
Step 5 — Generate the Video
Choose mode, tier, and camera based on content type and available assets.
Mode selection:
| Situation | Mode | Command |
|---|---|---|
| No reference images | | default |
| 1 image (first frame) | | |
| Start + end frames | | |
| Multi-ref blend | | up to 9 images |
Invoke the script:
bash library/social/social-media-video/scripts/run-social-video.sh \ --prompt "your director brief here" \ --platform instagram \ --camera drone \ [--mode t2v|i2v|first-last] \ [--file ref_image.jpg] \ [--gen-ref "reference image prompt"] \ [--tier global] \ [--quality high] \ [--view]
Platform Specs
| Platform | Format | Aspect | Duration | Notes |
|---|---|---|---|---|
| Instagram Reels | Vertical | 9:16 | 10–15s | Hook in first 1s |
| Instagram Feed | Square | 1:1 | 10s | Static-feel works well |
| TikTok | Vertical | 9:16 | 10–15s | High energy, fast cuts |
| YouTube Shorts | Vertical | 9:16 | 15s | Max quality |
| Landscape | 16:9 | 10–15s | Professional tone | |
| Twitter/X | Landscape | 16:9 | 10s | Punchy, direct |
| YouTube (long) | Landscape | 16:9 | 15s | Cinematic, slow builds |
| Portrait | 4:3 | 10s | Lifestyle-forward |
Tier note: Use
or--tier globalfor--tier vipand1:1formats. Chinese tier supports only 16:9, 9:16, 4:3, 3:4.21:9
Camera Language Reference
Standard Camera Intents (--camera / --intent flags)
| Intent | Movement | Best For |
|---|---|---|
| Slow crane up, wide establishing | Product launches, brand reveals |
| Dolly in + orbit, low hero angle | Brand manifesto, emotional story |
| Static macro orbit, precision reveal | E-commerce, product demo |
| Tracking shot, Steadicam | Testimonials, story-driven |
| Handheld jitter, dutch angle | High-energy, urgency |
| Reactive handheld, punchy zooms | Lighthearted brand content |
Specialty Camera Intents (New)
| Intent | Description | Best For |
|---|---|---|
| First-person subjective POV — immersive GoPro-style, continuous forward motion, peripheral detail close-ups | Action brands, travel, sports, tech demos |
| Aerial cinematic flythrough — smooth gimbal-stabilized, sweeping laterals, descend from high altitude into scene | Real estate, luxury, outdoor brands, epic reveals |
| Ground-level architectural flythrough — continuous dolly through space, seamless portal transitions | Architecture, interior design, venue showcases |
FPV Prompt Enrichment:
Immersive first-person POV shot. Camera glides forward through [scene] at eye level. Slight natural motion stabilization with GoPro-style wide angle. Peripheral detail rushing past — [details]. Smooth continuous forward motion. No cuts throughout. [Subject] visible in foreground periphery.
Drone Flythrough Prompt Enrichment:
Cinematic aerial drone shot. Camera descends from 200m altitude toward [subject/scene], sweeping lateral arc as it descends. Gimbal-stabilized smooth motion. Golden hour atmosphere, long shadows across [terrain/scene]. Final frame settles into medium establishing shot. Aerial cinematography, DJI Inspire aesthetic.
Prompt Quality Checklist
Before finalizing the Seedance prompt, verify:
- Scene environment is physically specific (not "nice background")
- Camera movement named explicitly (dolly in, orbit, drone flythrough, FPV, etc.)
- Lighting described technically (volumetric god rays, rim lighting, soft diffused, etc.)
- Subject/product described with visual specifics from brand-identity.md
- Sound direction included (even one line)
- Timecodes used for 10s+ videos
-
etc. referenced if images are provided@image1 - Brand CTA or tagline included in final seconds
- No vague adjectives ("amazing", "beautiful", "stunning") — replaced with technical terms
Example: Full Workflow
User: "Make an Instagram Reel for our cold brew coffee brand, drone shot, premium feel"
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.")
Step 2 — Storyboard:
0–2s: Drone descends over rooftop terrace at sunrise, fog below. 2–5s: Drone swoops down toward coffee cup on white marble, steam rising. 5–9s: Close-up orbit of bottle, specular gold highlights, ice cubes. 9–11s: Product settles, black screen fades in: "Zero Compromise." + logo Sound: Minimal lounge beat, coffee pour sound effect at 5s.
Step 3 — Seedance Director Prompt:
0–2s: Cinematic aerial drone shot. Camera descends at 30° angle toward a rooftop terrace at sunrise. Golden hour atmosphere, San Francisco bay fog below horizon. Gimbal-stabilized smooth descent. 2–5s: Drone rapidly closes toward a glass of cold brew coffee on white marble. Steam curling upward. Macro lens approach. Caustic light patterns on wet glass surface. 5–9s: Slow precision orbit around cold brew bottle. Black matte label with gold embossed text catching specular highlights. Ice cubes with subsurface light scattering. Commercial macro aesthetic. 9–11s: Static product hero shot. Letterbox crop, deep focus, black fade in from sides. Sound: Minimal ambient beat, single piano note, coffee liquid sound effect at 5s mark. Maintain cinematic color grade — deep blacks, warm gold midtones throughout.
Step 4 — Generate reference:
google-imagen4-ultra → cold brew bottle product shot (9:16)
Step 5 — Generate video:
bash library/social/social-media-video/scripts/run-social-video.sh \ --prompt "0–2s: Cinematic aerial drone shot..." \ --platform instagram \ --camera drone \ --mode i2v \ --file media_outputs/coldbrew_ref.jpg \ --duration 11 \ --tier global \ --view
Common Mistakes to Avoid
- Reading brand files and ignoring them — the storyboard must visually match the brand palette and tone.
- Generic prompts — "a nice video of a product" produces generic output. Every token must direct.
- Wrong tier for aspect ratio — 1:1 and 21:9 require
or--tier global
.--tier vip - Forgetting sound — Seedance generates audio. Direct it, or you get random results.
- FPV with static subject — FPV requires continuous motion in the scene. Pair with movement-rich environments.
- Drone without establishing shot — drone works best when it resolves INTO something (a product, a scene, a subject).
- Too many scene changes in 5s — match complexity to duration. 5s = 1 beat. 15s = 3–4 beats.