h3-skill

name	H3 官方默认 Skill
description	为 MiniMax H3 的五种视频生成模式（T2VA、I2VA、FL2VA、L2VA 和 Ref2VA）编写结构化的提示信息
compatibility	Portable to any agent that can read local files — no external API calls, MiniMax Hub tools, or proprietary runtime required. The agents/openai.yaml file only adds optional ChatGPT/Codex UI metadata; it does not restrict the skill to OpenAI agents.

H3 Prompt Writing

Workflow

1. Identify the input mode: T2VA, I2VA, FL2VA, L2VA, or full-reference Ref2VA.
2. For base text/keyframe modes, read references/base-en.txt and follow its final prompt structure.
3. For full-reference mode, first apply the full-reference structure and shared rules in this file, then read references/ref-en.txt for the remaining reference-specific rules and complete example.
4. Preserve the exact field names, section order, labels, and timing notation from the selected guide.

Base Modes

• T2VA: build the full audiovisual timeline from text.
• I2VA: start from the first frame and develop forward from it.
• FL2VA: describe the continuous path between the first and last frames.
• L2VA: infer a plausible opening and converge to the supplied last frame.

Use integrated_multimodal_description, overall_soundscape, and non_diegetic_music in the order shown in references/base-en.txt.

Full-Reference Mode

Ref2VA rewrites use subject_definitions, summary, retention_analysis, detailed_description, overall_soundscape, and non_diegetic_music in that order. Reference labels stay consistent across all sections.

This guide explains how rewrite outputs are organized and written in full-reference mode.

Write all six rewrite sections in English. Preserve the original language only for dialogue and lyrics inside <d> and for text visibly present in the scene.

Description detail: Make detailed_description as detailed and explicit as possible. For each shot, clearly establish the current composition, subject appearance and position, environment and lighting, actions and state changes, camera movement, current sound, and the points where referenced content actually appears or takes effect. Avoid reducing the description to a plot summary or a list of reference relationships.

The basic formats for shots, camera movement, speakers, dialogue, and ordinary sound are shared with the Video Prompt Writing Guide (T2VA / I2VA / FL2VA / L2VA). This guide focuses on the reference labels, analysis sections, and format differences specific to full-reference mode.

1. Overall Structure

A complete rewrite output consists of six sections in the following order:

Section	Purpose
subject_definitions	Defines referenced content and its reference labels
summary	Summarizes the task type, target video, and main reference relationships
retention_analysis	Describes how referenced content is preserved, transferred, or reused
detailed_description	Describes visuals, actions, shots, sound, and dialogue in playback order
overall_soundscape	Summarizes ambience and physical sounds
non_diegetic_music	Describes background music audible only to the audience

5.1 Basic Format

The basic format follows the Video Prompt Writing Guide (T2VA / I2VA / FL2VA / L2VA):

• Write the body in English. Preserve the original language of dialogue, lyrics, and visible text.
• [Shot 1] marks the opening shot and has no timestamp. Later shots use [Shot N] At MM:SS.mmm, ... to mark cut times.
• Write camera movement as natural English within the current shot, including movement type, amplitude, and speed when they need to be expressed.
• Give vocal sources stable (S1), (S2), and subsequent IDs. Write dialogue and lyrics as <d>[Language] ...</d>.
• Use <scenetrans>, <cutoff>, and the corresponding continuity descriptions for dialogue crossing a cut, speech truncated by the video ending, and continuous audio across shots.

For complete rules and examples covering camera vocabulary, group speech, voice-over, dialogue across cuts, and visible text, see the Video Prompt Writing Guide (T2VA / I2VA / FL2VA / L2VA).

6. overall_soundscape and non_diegetic_music

The definitions of these two sound categories follow the Video Prompt Writing Guide (T2VA / I2VA / FL2VA / L2VA).

overall_soundscape summarizes ambience and physical sounds across the full video. Dialogue, singing, and sound events synchronized to a particular shot remain in detailed_description:

overall_soundscape: Quiet indoor room tone and a low ventilation hum continue throughout the video.

non_diegetic_music describes background music that the characters cannot hear and that is audible only to the audience. When music is present, state its instrumentation, tempo, and dynamic development:

non_diegetic_music: A restrained solo-piano score at a slow tempo, with sustained low cello underneath and no swell.

When reference audio is used, state its copy or reference relationship only in the section that matches the audible layer: ambience and sound effects belong in overall_soundscape, while audience-only score belongs in non_diegetic_music. If the same audio provides both kinds of content, describe the corresponding relationship in each section:

overall_soundscape: The copied ambience layer from <Audio 1> continues throughout the target video.
non_diegetic_music: <Audio 2> is directly reused as the complete audience-only score.

Write complete dialogue and lyrics only inside <d> in detailed_description; do not repeat them in these two sections.

Output Rules

• Write rewrite sections in English; preserve dialogue, lyrics, and visible scene text in their original language.
• Describe each shot by composition, subjects, environment, actions, camera, sound, and the exact point where referenced content appears.
• Avoid plot summaries, unresolved reference labels, and timing that does not match the requested duration.

Tips for Better Results

• Always match the total duration of the description to the requested video length (4–15 seconds).
• Keep reference labels consistent (e.g. <Picture 1>, <Video 1>, <Audio 1>) across every section.
• Prefer concrete visual and audio details over abstract words like "cinematic" or "beautiful".
• When using keyframes (I2VA / FL2VA / L2VA), clearly state how the first and/or last frame connects to the timeline.