Agent skill

Hailuo Prompting

by nodetool-ai in nodetool-ai/nodetool

Prompt MiniMax's Hailuo video line — the chronological beat order it animates from, the fifteen bracketed camera commands the Director endpoints accept and the three-per-bracket rule, when to switch…

AGPL-3.0Auto-check passedMedia & Creative

Install Hailuo Prompting

skills CLI
$ npx skills add nodetool-ai/nodetool --skill hailuo-prompting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nodetool-ai/nodetool hailuo-prompting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/system-skills/hailuo-prompting .claude/skills/hailuo-prompting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hailuo-prompting
GitHub stars
560
Token cost
~1.3k tokens
SKILL.md length
651 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Prompt MiniMax's Hailuo video line — the chronological beat order it animates from, the fifteen bracketed camera commands the Director endpoints accept and the three-per-bracket rule, when to switch…

  • The model id names Hailuo
  • SKILL.md covers Write the action as beats, Camera, prompt_optimizer and Image to video, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • MiniMax video-01 (fal-ai/minimax/hailuo-2.3/pro/text-to-video

What it does

Hailuo Prompting is an agent skill from nodetool-ai/nodetool. Prompt MiniMax's Hailuo video line — the chronological beat order it animates from, the fifteen bracketed camera commands the Director endpoints accept and the three-per-bracket rule, when to switch promptoptimizer off, why there is no negative prompt to fall back on, and prompting the delta on image-to-video. Use whenever the model id names Hailuo or MiniMax video-01 (fal-ai/minimax/hailuo-2.3/pro/text-to-video, fal-ai/minimax/hailuo-02/pro/image-to-video, fal-ai/minimax/hailuo-02-fast/image-to-video…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering AI video generation and Prompt engineering. It works with fal and MiniMax. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • The model id names Hailuo
  • MiniMax video-01 (fal-ai/minimax/hailuo-2.3/pro/text-to-video
  • Fal-ai/minimax/hailuo-02/pro/image-to-video
  • Fal-ai/minimax/hailuo-02-fast/image-to-video

Example prompts

  • “/hailuo-prompting”

What it can do on your machine

Read from SKILL.md and the folder at commit fefb6d1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • fal.ai
    • akool.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hailuo Prompting loads about 1.3k tokens when it runs. Until then it costs about 195 tokens; SKILL.md has 651 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~195
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nodetool-ai/nodetool at commit fefb6d1, republished under its AGPL-3.0 licence (© nodetool-ai). 651 words, ~1,287 tokens.

Download SKILL.mdSave it as .claude/skills/hailuo-prompting/SKILL.md (or your agent's skills folder).
name
hailuo-prompting
description
Prompt MiniMax's Hailuo video line — the chronological beat order it animates from, the fifteen bracketed camera commands the Director endpoints accept and the three-per-bracket rule, when to switch prompt_optimizer off, why there is no negative prompt to fall back on, and prompting the delta on image-to-video. Use whenever the model id names Hailuo or MiniMax video-01 (fal-ai/minimax/hailuo-2.3/pro/text-to-video, fal-ai/minimax/hailuo-02/pro/image-to-video, fal-ai/minimax/hailuo-02-fast/image-to-video, fal-ai/minimax/video-01-director, fal-ai/minimax/video-01-subject-reference, hailuo/2-3-image-to-video-pro, minimax/hailuo-2.3, minimax/hailuo-02-fast) on generate_video, animate_image or a TextToVideo node. Not for MiniMax H3, which has its own guide.

Hailuo → a sequence of beats, in order

Hailuo animates the order it reads. It has no negative prompt, no shot list and no CFG dial, so every control you get is in the wording: what happens, in what order, and how the camera behaves while it happens. Clips run 6 or 10 seconds (10 s is unavailable at 1080p on Hailuo 02).

Reach it with find_model for text_to_video or image_to_video, then generate_video / animate_image.

Write the action as beats

Break one motion into the beats it is made of and connect them with sequencing words — first, then, as, finally. The model animates that order.

A skateboarder rolls toward a handrail in an empty underground car park. First he crouches low over the deck, then he pops the tail and the board snaps up under him, and as he lands on the rail the trucks grind along the steel, sparks trailing behind. Finally he drops off the end and rolls out of frame past a pillar.

Compare "a skateboarder does a trick on a rail", which gives the model the whole choreography to invent and no reason to resolve it the way you meant.

Emotional beats work the same way. "She reads the letter with growing concern, tears well up, then she crumples the paper and throws it" is three animatable states; "she is sad about the letter" is one adjective.

Camera

On the Director endpoints (video-01-director and its image-to-video form), camera moves are commands in square brackets. Fifteen are supported:

[Truck left] [Truck right] [Pan left] [Pan right] [Push in] [Pull out] [Pedestal up] [Pedestal down] [Tilt up] [Tilt down] [Zoom in] [Zoom out] [Shake] [Tracking shot] [Static shot]

Two placement rules carry all of it. Commands inside one bracket happen at the same time, capped at three: [Truck left, Pan right, Zoom in]. Commands at different points in the prompt happen in that order:

[Static shot] The chef sets the plate down under the pass light. [Push in]
He wipes the rim with a cloth, then looks up. [Tilt up, Pan right] The dining
room comes into view behind him.

Every other Hailuo endpoint takes camera direction as prose only — "a slow tracking shot follows her", "the camera racks focus from the leaves to her face". Brackets there are just text.

prompt_optimizer

On by default across the whole line, it rewrites your prompt with an LLM before generation. Leave it on for a short prompt: it fills in the detail you did not write. Switch it off once your prompt is a deliberate brief — it will otherwise rewrite away the specific wardrobe, the specific light, and the beat order you just spent effort on.

Show full SKILL.md (243 more words)Show less

Image to video

The frame is already decided. Prompt only what changes: motion, camera, light over time, environment animation. Naming the subject briefly to anchor the reference is fine — "the red-haired woman turns slowly to face camera" — but a paragraph re-describing the still is a paragraph not spent on the delta.

Keep the framing consistent with the source. Asking a close-up input for a wide establishing move is how you get a hallucinated body.

video-01-subject-reference holds a face across the clip from one reference image; describe the person's action, not their appearance.

No negative prompt

There is no field, and "no text, no watermark, not blurry" in the prompt is read as content. Say what should be there instead. Empty sky, not "no birds". A bare concrete wall, not "no graffiti".

Symptoms

What went wrongWhat to change
The action resolves in the wrong orderNumber the beats with first / then / as / finally
The camera driftsUse a bracketed command on a Director endpoint, or name the move in prose
Your specifics disappearedSet prompt_optimizer false
A body appears where the input image was croppedMatch the prompt's framing to the input
The thing you excluded shows up anywayRewrite the exclusion as a positive description

Grade the render with analyze_video and detect_video_scenes, and understand_video when you need a written read of what landed.

Adapted from MiniMax's camera-movement contract as documented on the fal Director endpoints, and Akool's Hailuo prompt guide: https://fal.ai/models/fal-ai/minimax/video-01-director/api https://akool.com/blog-posts/minimax-hailuo-video-prompt-guide

© nodetool-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/system-skills/hailuo-prompting of nodetool-ai/nodetool.

Open the folder on GitHubat commit fefb6d1

Compare with similar skills

Hailuo Prompting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hailuo Prompting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hailuo Prompting this skillnodetool-ai/nodetool560—~1.3kAutomated safety check: PassAGPL-3.0
AI Video Gencalesthio/OpenMontage66k—~3kAutomated safety check: PassAGPL-3.0
AI Video Gencalesthio/OpenMontage66k—~2.8kAutomated safety check: PassAGPL-3.0
AI Video Generation0xsline/OpenChatCut2.2k—~4.3kAutomated safety check: PassAGPL-3.0
MiniMax H3 Video PromptingSlavaSexton/ComfyUI-Agent-Kit105—~2.5kAutomated safety check: PassApache-2.0
Hong Kong Comic Fighter for H3karuvanan/MiniMax-H3-Director-Cut-Studio132—~4.4kAutomated safety check: PassCustom licence

Similar skills

  • AI Video Gen

    calesthio/OpenMontage

    Generate AI videos from text prompts using multiple provider gateways.

    66k GitHub stars~3k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • AI Video Gen

    calesthio/OpenMontage

    Generate AI videos from text prompts using multiple provider gateways.

    66k GitHub stars~2.8k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • AI Video Generation

    0xsline/OpenChatCut

    Submits AI video generation jobs to Fal.ai, Seedance, Kling, MiniMax Hailuo, xAI Grok Imagine or OFox for text-to-video, image-to-video, transitions and clip extension.

    2.2k GitHub stars~4.3k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • MiniMax H3 Video Prompting

    SlavaSexton/ComfyUI-Agent-Kit

    Guides prompting and local ComfyUI use of MiniMax H3 (Hailuo 3), which generates video with synchronized audio, including prompt format, quants and troubleshooting.

    105 GitHub stars~2.5k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Hong Kong Comic Fighter for H3

    karuvanan/MiniMax-H3-Director-Cut-Studio

    Special skill that turns loaded Hong Kong comic panels into photoreal MiniMax H3 martial-arts sequences with readable attack and defence action.

    132 GitHub stars~4.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Dark Rescue H3 External Camera

    karuvanan/MiniMax-H3-Director-Cut-Studio

    Writes fictional, non-graphic rescue scenes for MiniMax H3 with an external cinematic camera, a visible rescuer, Mandarin dialogue and shot-by-shot direction.

    132 GitHub stars~1.7k tokensUpdated today
    Media & CreativeAuto-check passed

More from nodetool-ai/nodetool

All 127 skills in this repo
  • Beat Sync Editing

    nodetool-ai/nodetool

    Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.

    560 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Caption Titles

    nodetool-ai/nodetool

    Add and animate a consistent text layer on an existing NodeTool timeline.

    560 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Color Motion

    nodetool-ai/nodetool

    Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.

    560 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Commercial Beat Sheet

    nodetool-ai/nodetool

    Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.

    560 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Elevenlabs Audio Prompting

    nodetool-ai/nodetool

    Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…

    560 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Frame Composition

    nodetool-ai/nodetool

    Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.

    560 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Hailuo Prompting

What does Hailuo Prompting do?

Prompt MiniMax's Hailuo video line — the chronological beat order it animates from, the fifteen bracketed camera commands the Director endpoints accept and the three-per-bracket rule, when to switch…. Hailuo Prompting is an agent skill from nodetool-ai/nodetool. Prompt MiniMax's Hailuo video line — the chronological beat order it animates from, the fifteen bracketed camera commands the Director endpoints accept and the three-per-bracket rule, when to switch promptoptimizer off, why there is no negative prompt to fall back on, and prompting the delta on image-to-video.

When should I use Hailuo Prompting?

Hailuo Prompting fits situations like: the model id names Hailuo; miniMax video-01 (fal-ai/minimax/hailuo-2.3/pro/text-to-video; fal-ai/minimax/hailuo-02/pro/image-to-video; fal-ai/minimax/hailuo-02-fast/image-to-video.

How do I install Hailuo Prompting in Claude Code?

Run `npx skills add nodetool-ai/nodetool --skill hailuo-prompting -a claude-code`. Or copy the skill folder (packages/system-skills/hailuo-prompting in nodetool-ai/nodetool) into .claude/skills/hailuo-prompting in your project. Claude Code loads it when a task matches its description.

How do I install Hailuo Prompting in Codex?

Run `npx skills add nodetool-ai/nodetool --skill hailuo-prompting -a codex`. Or copy the skill folder (packages/system-skills/hailuo-prompting in nodetool-ai/nodetool) into .agents/skills/hailuo-prompting in your project. Codex loads it when a task matches its description.

Can I use Hailuo Prompting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill hailuo-prompting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hailuo-prompting, .gemini/skills/hailuo-prompting, .github/skills/hailuo-prompting and .opencode/skills/hailuo-prompting in your project.

What does Hailuo Prompting need to run?

SKILL.md names no scripts, command-line tools or credentials: Hailuo Prompting is instructions for the agent only.

Does Hailuo Prompting access the network?

SKILL.md names 2 domains. As links in the text: fal.ai and akool.com. This is read from the text; nothing was executed.

Is Hailuo Prompting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hailuo Prompting use?

Hailuo Prompting is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hailuo Prompting use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hailuo Prompting?

Skills that share tags, products or a category with Hailuo Prompting: AI Video Gen (calesthio/OpenMontage, 66k stars), AI Video Gen (calesthio/OpenMontage, 66k stars), AI Video Generation (0xsline/OpenChatCut, 2.2k stars) and MiniMax H3 Video Prompting (SlavaSexton/ComfyUI-Agent-Kit, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hailuo Prompting?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 560 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 11, 2026.

Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.