MCPInstall

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.

Installs
2.8K
Last 24h
+8
Trending rank
#9461
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-social-media-video
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads muapi-social-media-video automatically when relevant.

  3. 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.

Social 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:

FileWhat to extract
brand-identity.mdVisual style, color palette, tone, logo/product aesthetics, brand personality
ICP.mdTarget audience — who they are, their pain points, what motivates them
messaging.mdCore 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:

  1. Never use vague descriptors ("beautiful", "amazing", "8k"). Use technical cinematography language.
  2. Always specify camera movement, lens type, and lighting physically.
  3. For 10s+ videos, use timecode segments: 0–3s: [...] 3–7s: [...] 7–10s: [...]
  4. Integrate @image1, @image2 reference tags if images are provided.
  5. Always include sound direction (even brief) — Seedance generates audio.
  6. 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:

ScenarioModeImages Needed
Product showcasei2v1 product shot as first frame
Scene transitionfirst-last2 images — opening and closing frame
Brand characteri2v1 character reference
Pure conceptt2vNone — text only
Mood/style anchori2v1 style reference image

Image generation — best models by use case:

Use CaseRecommended ModelWhy
Photorealistic product/scenegoogle-imagen4-ultraHighest realism, great lighting
Concept art / stylizedflux-kontext-pro-t2iCreative fidelity, style adherence
Fastest turnaroundgoogle-imagen4-fastSpeed with good quality
Highly detailed/editorialhidream-i1-fullFine detail, editorial quality
Character with identityideogram-v3-t2iStrong 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:

SituationModeCommand
No reference imagest2vdefault
1 image (first frame)i2v--mode i2v --file ref.jpg
Start + end framesfirst-last--mode first-last --tier global --file start.jpg --file end.jpg
Multi-ref blendi2vup 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

PlatformFormatAspectDurationNotes
Instagram ReelsVertical9:1610–15sHook in first 1s
Instagram FeedSquare1:110sStatic-feel works well
TikTokVertical9:1610–15sHigh energy, fast cuts
YouTube ShortsVertical9:1615sMax quality
LinkedInLandscape16:910–15sProfessional tone
Twitter/XLandscape16:910sPunchy, direct
YouTube (long)Landscape16:915sCinematic, slow builds
PinterestPortrait4:310sLifestyle-forward

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.


Camera Language Reference

Standard Camera Intents (--camera / --intent flags)

IntentMovementBest For
revealSlow crane up, wide establishingProduct launches, brand reveals
epicDolly in + orbit, low hero angleBrand manifesto, emotional story
productStatic macro orbit, precision revealE-commerce, product demo
narrativeTracking shot, SteadicamTestimonials, story-driven
tenseHandheld jitter, dutch angleHigh-energy, urgency
comedyReactive handheld, punchy zoomsLighthearted brand content

Specialty Camera Intents (New)

IntentDescriptionBest For
fpvFirst-person subjective POV — immersive GoPro-style, continuous forward motion, peripheral detail close-upsAction brands, travel, sports, tech demos
droneAerial cinematic flythrough — smooth gimbal-stabilized, sweeping laterals, descend from high altitude into sceneReal estate, luxury, outdoor brands, epic reveals
flythroughGround-level architectural flythrough — continuous dolly through space, seamless portal transitionsArchitecture, 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
  • @image1 etc. referenced if images are provided
  • 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

  1. Reading brand files and ignoring them — the storyboard must visually match the brand palette and tone.
  2. Generic prompts — "a nice video of a product" produces generic output. Every token must direct.
  3. Wrong tier for aspect ratio — 1:1 and 21:9 require --tier global or --tier vip.
  4. Forgetting sound — Seedance generates audio. Direct it, or you get random results.
  5. FPV with static subject — FPV requires continuous motion in the scene. Pair with movement-rich environments.
  6. Drone without establishing shot — drone works best when it resolves INTO something (a product, a scene, a subject).
  7. Too many scene changes in 5s — match complexity to duration. 5s = 1 beat. 15s = 3–4 beats.

FAQ

What does the muapi-social-media-video skill do?

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.

How do I install muapi-social-media-video?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-social-media-video 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/muapi-social-media-video/ (personal) or .claude/skills/muapi-social-media-video/ (project).

Which AI agents can use muapi-social-media-video?

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 muapi-social-media-video 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 muapi-social-media-video?

It is published by samuraigpt in samuraigpt/generative-media-skills. It has 2,770 recorded installs.

More from samuraigpt/generative-media-skills

View all →

muapi-cinema-director

samuraigpt/generative-media-skills

Direct high-fidelity cinematic video with AI — translates creative intent into technical cinematographic directives for Veo3, Kling, and Luma video models via muapi.ai

Media & Creative3.1K installs

muapi-seedance-2

samuraigpt/generative-media-skills

Expert Cinema Director skill for Seedance 2.0 (ByteDance) — high-fidelity video generation across Chinese, Global, and VIP tiers. Supports text-to-video, image-to-video, first-last-frame, omni reference, character training, omni-reference training, video editing, and watermark removal.

Media & Creative3K installs

muapi-logo-creator

samuraigpt/generative-media-skills

Engineer professional-grade brand logos using geometric primitives and negative space — generates minimalist, scalable vector-style marks via muapi.ai

Marketing & SEO2.9K installs

muapi-nano-banana

samuraigpt/generative-media-skills

Reasoning-driven image generation using structured creative briefs (Gemini 3 style) — generates high-fidelity images via muapi.ai with logic-based prompting

Media & Creative2.8K installs

muapi-ui-design

samuraigpt/generative-media-skills

Generate high-fidelity UI/UX mockups for mobile and web apps using Atomic Design principles — creates wireframes and design systems via muapi.ai

Frontend & Design2.8K installs

muapi-youtube-shorts

samuraigpt/generative-media-skills

Auto-generate viral 9:16 YouTube Shorts (or TikTok / Reels clips) from a long-form video. Thin platform-aware wrapper around the AI Clipping skill — picks sensible defaults for short-form social platforms (9:16, 30–60s sweet spot) and delegates the actual highlight extraction + crop to muapi.ai's /ai-clipping endpoint.

Media & Creative2.7K installs

Popular media & creative skills

View category →

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 & Creative1.2M installs

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.

Media & Creative1.1M installs

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.

Media & Creative1M installs

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.

Media & Creative916.5K installs

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

Media & Creative881.5K installs

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

Media & Creative880.3K installs