scenario-minimax-video
Use when generating or editing video with MiniMax Hailuo models on Scenario via MCP: text-to-video, image-to-video, first and last frame anchors, reference images, videos, or audio, native stereo audio, bracketed camera commands, extending a clip, inserting a new scene into one, or recasting the peo…
Install / Use
npx skills add scenario-labs/skills --skill scenario-minimax-videoInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of scenario-minimax-video
scenario-minimax-video scores 84/100 on our quality scale, 2936th of 4,700 Development & Engineering skills we index.
Its SKILL.md is 10 KB long, well organised into 8 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 29 days ago, so scenario-minimax-video is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-minimax-video compared with similar skills
All 4 of these similar skills score higher than scenario-minimax-video; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-minimax-video (this skill)by scenario-labs | 84 | 1.0k | 29d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install scenario-minimax-video?
- Run
npx skills add scenario-labs/skills --skill scenario-minimax-video. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-minimax-video work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-minimax-video safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-minimax-video still maintained?
- The repository was last updated 29 days ago, so scenario-minimax-video is actively maintained.
Skill content
View source on GitHubname: scenario-minimax-video description: "Use when generating or editing video with MiniMax Hailuo models on Scenario via MCP: text-to-video, image-to-video, first and last frame anchors, reference images, videos, or audio, native stereo audio, bracketed camera commands, extending a clip, inserting a new scene into one, or recasting the people in it from photos. Keywords: MiniMax, Hailuo 3.0, H3, H3 Max, Turbo, Extend Video, Insert Video, Recast, Hailuo 2.3, T2V, I2V, V2V, 2K." license: MIT
Scenario MiniMax Video
Overview
MiniMax's Hailuo video family on Scenario has three kinds of member. H3 (Hailuo 3.0) folds text,
keyframe, and reference conditioning into one model and generates stereo audio in the same pass. The
H3 Max line splits that into single-mode members (text, image, reference, lip sync), each with a
faster Turbo twin on the first two. Three Max members edit a clip you already have instead of
generating one: Extend Video (with a Turbo twin), Insert Video, and Recast. The older Hailuo 2.3
pair carried a deprecated tag naming H3 as successor at authoring time. Discover members with
search and treat model_schema_get as the contract: they agree on almost nothing, not even the
spelling of a resolution.
Connection and the core loop: see the scenario skill in this repo; model-agnostic video work: the
scenario-video skill. If a sibling skill named here is missing from your available skills, load it
with skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
Quick reference
H3's mode follows from the inputs (names from the live schema):
| Mode | Inputs | Behavior |
| ------------ | ------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| Text | prompt | aspectRatio honored (21:9 through 9:16, default adaptive) |
| First frame | firstFrameImage (+ prompt) | shape follows the image; aspectRatio ignored |
| First + last | firstFrameImage + lastFrameImage | lastFrameImage is valid only alongside firstFrameImage |
| Reference | referenceImages, referenceVideos, referenceAudio | guides subject, style, motion, and voice, not forced frames; aspectRatio still applies |
Keyframes and references are mutually exclusive: neither frame combines with any reference array.
referenceAudio never rides alone; it requires at least one image or video reference. Reference
parameters are arrays even for one asset. At authoring time H3 took 9 reference images, 3 videos,
and 3 audio files (videos and audio each 2 to 15 seconds, and 2 to 15 seconds in total), 5 to 15
seconds of output, at 768P or 2K.
The 2.3 members take only prompt and firstFrameImage, plus a coupled pair: at authoring time 10
second duration was available only at 768p, and 1080p only at 6 seconds. Their
promptOptimizer (default true) rewrites the prompt before generation: leave it on for thin
prompts, switch it off when engineered wording must survive verbatim. H3 has no such switch, and
neither H3 nor 2.3 takes a seed.
Picking the member
H3 is the one member that mixes modes in a single call, and, lip sync aside, the one generator that
reaches 2K; it is also slow and expensive, and reference media adds more (reference videos bill
per second of uploaded footage). The Max text and image members cap at 768P and take a seed and
a promptExpansionMode (disabled, balanced, quality); set it to disabled when engineered
wording must survive verbatim. Their Turbo twins share the same inputs and are the iteration tier:
draft at 480P on Turbo, then spend the expensive member on the take you keep. A draft is a
composition and motion check, not a preview of the final pixels: a different member or resolution is
a new generation even with the same seed. dry_run the draft and the final payloads before a
batch. Re-discover a member before naming 2.3 for new work: deprecated members can disappear from
the catalog.
Editing a clip you already have
These members take the existing video as video (any video asset id, generated or uploaded) and
bill only what they make or touch, so price each with dry_run on the real source.
| Member | What it does | Key inputs and caps at authoring time |
| --------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Extend (+Turbo) | adds 1 to 15 s after the source | source 1.625 to 60 s, up to 50 MB, aspect 0.4 to 2.5; output extended returns source plus new footage, continuation the new footage behind a lead-in copied from the source (see Common mistakes); referenceAudio replaces the source soundtrack as the audio guide; aspectRatio other than auto crops; 480P to 2K |
| Insert Video | a new 5 to 13 s scene, then the original resumes | startTime and resumeTime in source seconds (both required); duration is the new scene only; up to 9 referenceImages and 3 referenceVideos, billed by reference tokens; colorMatch on by default; 480p or 768p, lowercase |
| Recast | swaps up to 4 people for new ones from photos | source 5 to 30 s, no single shot over 15 s, billed per source second; referenceImages one photo per person, required, mapped left to right by default; prompt optional, to say who becomes whom; motion, camera, cuts, and audio are kept; 768P or 1080P |
Write an Extend prompt about what happens next, never a description of the source: the model already
sees it, and enablePromptExpansion (on by default) rewrites the prompt from the source to keep the
continuation consistent. Recast is the lane for re-shooting the same performance with a different
person; it keeps everything else, so it is the wrong tool for a new setting or style.
Camera in brackets, motion in moderation
The whole family reads bracketed camera commands inline in the prompt: [Push in], [Pull out],
[Pan left], [Tilt up], [Truck right], [Pedestal up], [Zoom out], [Shake],
[Tracking shot], [Static shot]. Up to three moves combine in one bracket
([Pan left, Pedestal up]); separate brackets sequence them. Keep 2 or 3 motion cues per shot in
total: piling on moves invites background wobble and texture flicker. Image-to-video tends to drift
even unprompted, so lock statics explicitly ("Static camera, locked shot, tripod mounted").
Write the rest as natural prose, ordered camera, subject, action, scene, lighting and mood, style. On H3, sound lives in the prompt too: describe dialogue lines, SFX, and ambience inline so they sync to the action; no audio parameter exists to switch instead.
Worked example: a character clip from reference stills
searchwithtarget="models",query="minimax hailuo",public=true. Prefer the newest non-deprecated hit, e.g.model_minimax-h3(a live hit at authoring time: re-discover each session).model_schema_getwith that id: modes, caps, and allowed values before anything else.upload_assettwo clean, evenly lit character stills (see thescenarioskill) to get asset ids.model_runwith thatmodel_id,dry_run=true, and the exactparameters={"prompt": "[Tracking shot] The scout from the reference images sprints across a rooftop at dusk, coat snapping in the wind, warm rim light, footsteps and distant traffic in the audio, cinematic realism.", "referenceImages": ["asset_a", "asset_b"], "duration": 8, "resolution": "2K", "aspectRatio": "16:9"}for the cost estimate; re-estimate after changing duration, resolution, or the reference count.- Repeat
model_runwithwait=false, thenjobs_waitwith the returned job id, re-called withpending_job_idson timeout, never a secondmodel_run; H3 at 2K commonly runs several minutes. asset_displaythe output and review it with sound on: dialogue and SFX sync are part of what you paid for.
Common mistakes
- Combining
firstFrameImagewith a reference array: keyframes and references never mix. - Passing
referenceAudioalone: it requires at least one image or video reference. - Sending
lastFrameImagewithoutfirstFrameImage: the pair anchors both endpoints or neither. - Expecting
aspectRatioto win over a first frame: the shape follows the image. - Carrying one member's values to another: H3 spells resolutions
768Pand2K, the Max generators other than lip sync stop at768P, Insert spells480pand768pin lowercase, and Recast offers only768Pand1080P. - Sending Recast a clip with a single shot over 15 seconds, or one under 5: cut it first (the
scenario-video-editingskill). - Pricing Recast on the output: it bills every second of the source, so trim the source to the part that needs the new people.
- Expecting either Extend output to be new footage only:
extendedreturns the source plus the continuation, andcontinuationopens on a copy of the source's last 1.625 s (39 frames at 24 fps in two authoring-time runs), then new footage that ran a little past the request (2 s gave 2.1 s, 3 s gave 3.5 s, each billed as requested). For pieces assembled later (thescenario-video-assemblyskill), takecontinuationand cut fromstartTime1.7: the cut tool steps by 0.1 s and 1.6 keeps a source frame (thescenario-video-editingskill). - Stacking camera moves: past 2 or 3 cues the background wobbles and textures flicker.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
