
higgsfield-video-explainer
Build a complete non-photoreal narrated explainer or story video from ordered 10-second blocks: one narrator, one universal style key, one Seed Audio take and one Gemini Omni clip per block, then server-side assembly with explainervideo. Use when: "make an explainer video", "explain this in a video", "turn this topic or document into a narrated video", "tell this story as an animated video", "make a faceless narrated video", or "show me explainer styles". Supports live CMS presets, custom style references, mascot/faceless modes, two aspects, and optional burned subtitles. NOT for: photoreal films, ads/UGC, talking heads, podcasts, motion typography reels, one-off clips without narration, or editing a finished video.
- Installs
- 143.8K
- Last 24h
- +1.3K
- Trending rank
- #224
- Security
- Fail
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/higgsfield-ai/skills --skill higgsfield-video-explainer- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads higgsfield-video-explainer automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
Security audits
Independent scans of the skill's instructions and bundled files.
SKILL.md
The instructions your agent reads when the skill is triggered.
Higgsfield Video Explainer
Run the MCP video-explainer workflow through Higgsfield CLI. Lock one visual style key, write one narration line and one matching visual prompt per 10-second block, generate every voice take first, generate every clip second, then immediately assemble the ordered pairs with explainer_video.
Never use the monolithic video_explainer job in this skill.
MCP-to-CLI mapping
| MCP workflow operation | CLI equivalent |
|---|---|
get_explainer_presets | higgsfield preset list video-explainer --json |
resolve_explainer_preset | higgsfield preset resolve video-explainer <preset_id> --json |
generate_image / nano_banana_pro | higgsfield generate create nano_banana_2 ... |
list_voices | higgsfield voices list --json |
generate_audio / seed_audio | higgsfield generate create seed_audio ... |
generate_video / gemini_omni | higgsfield generate create gemini_omni ... |
job_status | --wait --json or higgsfield generate wait <job_id> --json |
explainer_video | higgsfield generate create explainer_video ... |
nano_banana_2 is the public CLI id for the Nano Banana Pro style-key model used by the MCP workflow.
Bootstrap
-
If
higgsfieldis unavailable, install it:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh -
If
higgsfield account statusfails, ask the user to runhiggsfield auth login, then wait. -
Inspect the live contracts before the first submission:
higgsfield model get nano_banana_2 higgsfield model get seed_audio higgsfield model get gemini_omni higgsfield model get explainer_video
Phase 0 — ask first
Collect choices in two separate turns, in this order. Never merge them.
Turn 1 — style only
Always load the live CMS catalog:
higgsfield preset list video-explainer --json
Show the preset names with their thumbnail/video preview URLs. Say one short line asking the user to pick a preset, describe a custom style, or attach style-reference images, then end the turn. Do not ask production questions in the same turn. Choosing a style is mandatory; never choose silently unless the user explicitly says “you choose.”
Skip this turn only when the request already contains explainer preset id: <uuid>. Confirm that UUID exists in the live catalog and keep it for Phase 1.
Turn 2 — production settings
Only after style selection, collect every unresolved setting:
- Duration: one to ten whole minutes.
N = duration_minutes × 6fixed 10-second blocks. - Narration language: English by default, but still offer the choice.
- Character: recurring mascot or faceless stylistic scenes. Always ask.
- Aspect:
16:9by default or9:16vertical. - Subtitles: off by default. Explain that subtitles cost 0.05 credit per voiced block. If enabled, make the user choose
patrick,caveat,marker, oranton; never choose silently.
Every choice belongs to the user unless they explicitly delegate it.
Inputs
- Topic or personal/philosophical story.
- Optional local source documents; read/extract them before scripting. They are factual input, not generation media.
- Optional preset UUID, mutually exclusive with custom style-reference images.
- Optional style-reference images. Use only their rendering style and color grading; never copy their people, text, logos, or objects unless requested.
- Duration, language, character mode, aspect, and subtitle choice from Phase 0.
For local style donors, pass each path with a repeated --image. For a web image, download it locally first or use an existing uploaded media ID.
Hard rules
- Keep every visual strictly non-photorealistic. Repeat the same STYLE descriptor and non-realism negatives in every clip prompt.
- Keep all spoken words out of video generation. Clip audio is ambient sound or music only; no dialogue, lip-sync, or baked narration.
- Use exactly one narration take and one clip per labeled block. Block N audio always maps to Block N video.
- Attach the same style-key image to every clip.
- Write all image/video prompts in English. Only narration uses the selected language.
- Research real topics before scripting. Do not invent quotes, dates, numbers, or events.
- Assemble automatically in the same run. Returning loose clips is a failure.
Pipeline
| Phase | Output | CLI |
|---|---|---|
| 0 Ask | style first; then duration, language, character, aspect, subtitles | preset list + user questions |
| R Research | verified facts and sources | available research tools |
| 1 Style key | one universal style image | preset resolve or nano_banana_2 |
| 2 Narration | N labeled narration lines | reasoning |
| 3 Block prompts | N labeled video prompts | reasoning |
| 4 Voice | user selects one voice; generate N takes | voices list + seed_audio |
| 5 Clips | generate N 10-second clips | gemini_omni |
| 6 Assemble | one final MP4 | explainer_video |
Read references/prompts.md before Phases 1–3.
Phase R — research
For a real topic, use available web research tools and authoritative sources to verify enough facts for every block. Keep a short Sources list. Never script a factual explainer from memory alone.
For a personal story, skip web research and use only details supplied by the user. Invent nothing factual.
Phase 1 — create or resolve the style key
Write one reusable STYLE descriptor: medium, palette, line/fill behavior, texture/finish, then non-photorealistic, illustrated, not a photo, no live-action, no realism.
Selected CMS preset
Resolve the hidden style image into the active workspace:
higgsfield preset resolve video-explainer "<preset UUID>" --json
Keep the returned media_id as STYLE_KEY_ID. Skip image generation: this imported media is the style key. Build the STYLE descriptor from the returned preset name plus the mandatory non-photoreal rules. Do not recreate a preset from its name.
The preset reference controls framing. If it conflicts with the aspect requested in Phase 0, stop and let the user choose rather than silently fighting the reference.
Custom style or reference images
Generate exactly one key image. Use the abstract swatch template from references/prompts.md, or its mascot variant when character mode is enabled. Repeat --image for every style donor:
higgsfield generate create nano_banana_2 \
--prompt "<style-key prompt>" \
--aspect_ratio 16:9 \
--resolution 2k \
--wait \
--json
Use 9:16 for vertical. Keep the completed image job UUID as STYLE_KEY_ID; later CLI generations can reuse a completed job UUID as an image reference.
Phase 2 — write narration
Write exactly N labeled narration blocks in the selected language:
Block 1
<line spoken over clip 1>
Block 2
<line spoken over clip 2>
- One line per block, usually 20–24 words and about 8–9 seconds.
- Keep every take under roughly 9.5 seconds.
- Use plain spoken text only: no timecodes, emotion cues, parentheticals, or stage directions.
- Spell numbers out.
- Use a concrete tone and never say “in this video.”
- For a topic, build from hook through payoff. For a personal story, preserve the user's details and protagonist.
Phase 3 — write matching video prompts
Write exactly N labeled English prompts using the template in references/prompts.md:
Block N
STYLE REFERENCE: Match the attached reference image EXACTLY. <same STYLE descriptor>
SCENE: <one scene and action matching Block N narration>
MOTION: <camera move and animation behavior>
AUDIO: <ambient SFX or music only; no voice, dialogue, or narration>
NEGATIVE: <style drift and realism bans; no lip-sync, captions, text, logos, or watermark>
For mascot mode, Block 1 greets by gesture with mouth closed, the final block waves a sign-off, and middle blocks use consistent cameos only when useful. For faceless mode, use stylistic scenes only. Keep one clear action per block.
Phase 4 — generate every voice take first
List the live voices, present the choices, and wait for the user to select one narrator:
higgsfield voices list --json
Keep the selected voice's exact id and type (preset or element). Never invent or auto-pick a voice unless the user explicitly delegates it.
Generate one completed seed_audio job per narration block, always with the same voice:
higgsfield generate create seed_audio \
--prompt "<Block N narration only>" \
--voice_type "<preset|element>" \
--voice_id "<voice UUID>" \
--wait \
--json
Record every audio job UUID in block order. Regenerate only a failed or excessively long take. Shorten that block or adjust --speech_rate modestly when needed. Do not begin Phase 5 until all N audio jobs are complete.
Phase 5 — generate every clip second
Generate one completed 10-second gemini_omni clip per block. Attach the same style key to every call:
higgsfield generate create gemini_omni \
--prompt "<Block N video prompt>" \
--image "<STYLE_KEY_ID>" \
--duration 10 \
--resolution 720p \
--aspect_ratio 16:9 \
--wait \
--json
Use 9:16 when selected. Record every video job UUID in block order. Independent jobs may run concurrently inside this phase, but the audio-phase barrier is strict. Re-submit only failed blocks. Never silently replace gemini_omni; inspect the live video catalog if the model is unavailable.
Phase 6 — assemble immediately
Create blocks.json with at least two ordered block pairs. The CLI model contract requires typed references, so use the generic completed-job types:
[
{
"video": {"id": "<clip 1 job UUID>", "type": "video_job"},
"audio": {"id": "<voice 1 job UUID>", "type": "audio_job"}
},
{
"video": {"id": "<clip 2 job UUID>", "type": "video_job"},
"audio": {"id": "<voice 2 job UUID>", "type": "audio_job"}
}
]
Submit the server-side assembler immediately:
higgsfield generate create explainer_video \
--items @blocks.json \
--width 1280 \
--height 720 \
--wait \
--json
Use --width 720 --height 1280 for vertical. When subtitles are enabled, add the chosen font:
--subtitles '{"font":"patrick"}'
The assembler keeps each block at exactly 10 seconds: it centers short voice takes, pitch-safely speeds small overruns, never stretches video, concatenates blocks in order, and optionally burns timed captions. Total duration is exactly N × 10 seconds.
Do not use local ffmpeg, the legacy assembly scripts, or the monolithic video_explainer job.
Checkpoints and recovery
- Before Phase 5: require one style key, exactly
Nnarration lines and prompts, one selected voice, andNcompleted audio jobs. - Before Phase 6: require
Ncompleted video jobs and exact one-to-one block pairing with no missing or duplicate IDs. - Preset missing: refresh
preset list; never reuse or fabricate an ID. - Preset resolve failure: verify workspace selection and retry once.
- Style drift or realism: strengthen the shared STYLE and NEGATIVE text, then regenerate only that clip.
- Timeout: rejoin with
higgsfield generate wait <job_id> --json; never duplicate a running job. - Two identical failures mean the prompt or parameters must change.
Deliver
Return the final assembled video URL, exact duration, aspect, narration language, selected style, narrator, subtitle status, and a Sources list for researched topics. Keep intermediate job IDs and loose asset URLs internal unless requested.
FAQ
What does the higgsfield-video-explainer skill do?
Build a complete non-photoreal narrated explainer or story video from ordered 10-second blocks: one narrator, one universal style key, one Seed Audio take and one Gemini Omni clip per block, then server-side assembly with explainervideo. Use when: "make an explainer video", "explain this in a video", "turn this topic or document into a narrated video", "tell this story as an animated video", "make a faceless narrated video", or "show me explainer styles". Supports live CMS presets, custom style references, mascot/faceless modes, two aspects, and optional burned subtitles. NOT for: photoreal films, ads/UGC, talking heads, podcasts, motion typography reels, one-off clips without narration, or editing a finished video.
How do I install higgsfield-video-explainer?
Run npx skills add https://github.com/higgsfield-ai/skills --skill higgsfield-video-explainer 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/higgsfield-video-explainer/ (personal) or .claude/skills/higgsfield-video-explainer/ (project).
Which AI agents can use higgsfield-video-explainer?
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 higgsfield-video-explainer safe to install?
Security partners have reviewed it: Gen Agent Trust Hub flagged risks; Socket passed; Snyk flagged items to review. As with any skill, read the SKILL.md and bundled scripts before installing.
Who maintains higgsfield-video-explainer?
It is published by higgsfield-ai in higgsfield-ai/skills. It has 143,769 recorded installs.
More from higgsfield-ai/skills
higgsfield-generate
higgsfield-ai/skills
Generate images/videos/3D assets/audio via Higgsfield AI. Defaults: GPT Image 2.5 for image/design/text, Seedance 2.5 for video, Nano Banana 2 for cartoon characters, Marketing Studio for ads, Seed Audio 1.0 for audio. Use when: "generate an image", "make a video", "animate this photo", "image-to-video", "edit/stylize/remix this image", "reframe this video", "edit this video from a sketch", "create a 3D model/GLB", "create a sound effect", "make music", "text-to-audio", "create an ad", "make a UGC video", "unboxing", "presenter video", "import product from URL", or "analyze video virality". Supports generic generation, workflows, Marketing Studio, and Virality Predictor. Chain with higgsfield-soul-id for face/identity consistency. NOT for: Soul training, brand systems/brandbooks (use higgsfield-brandkit), photoshoots, cards, YouTube thumbnails (use higgsfield-youtube-thumbnail), explainers (use higgsfield-video-explainer), playable games/assets (use higgsfield-websites), or TTS.
higgsfield-product-photoshoot
higgsfield-ai/skills
Generate brand-quality product images through Higgsfield product-photoshoot prompt enhancement on GPT Image 2 / gptimage2. Entry point for professional brand/product visuals. Use when: "product photo", "studio shot", "lifestyle image", "Pinterest pin", "hero/banner", "carousel", "ad creative", "Meta ads", "virtual try-on", "model wearing", "person holding product", "closeup with hands", "levitating/floating/splash product", "CGI/surreal product", "restyle", "seasonal/aesthetic variation", or any product, brand, or paid-social creative. Modes: productshot, lifestylescene, closeupproductwithperson, moodboardpin, herobanner, socialcarousel, adcreativepack, virtualmodeltryout, conceptualproduct, restyle. Backend assembles the final prompt; never freehand it. NOT for: no-product text-to-image (use higgsfield-generate), branded avatar video (use higgsfield-generate Marketing Studio), marketplace listing cards (use higgsfield-marketplace-cards), Soul Character training (use hig
higgsfield-soul-id
higgsfield-ai/skills
Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my Soul", "train my face", "make my digital twin", "build me an avatar", "learn my appearance", "create a character of me", "set up identity for video", "I want my face in generated images". Chain: train Soul (one-time, returns referenceid) → use in higgsfield-generate via --soul-id with models like text2imagesoulv2 or soulcinematic. NOT for: one-shot face swaps (use higgsfield-generate with --image), named-character / non-photo avatars (use higgsfield-generate with prompt).
higgsfield-marketplace-cards
higgsfield-ai/skills
Generate marketplace product image cards through Higgsfield: compliant main image, secondary product images, and A+ style content modules. Use when the user asks for marketplace listing images, product detail cards, secondary product images, product infographics, lifestyle listing shots, A+ style content, marketplace image sets, or sales-ready product visuals. Backend owns marketplace compliance references and prompt templates; this skill only routes user intent to the CLI. NOT for generic brand product photography without marketplace/listing context (use higgsfield-product-photoshoot), video generation or UGC ads (use higgsfield-generate), or Soul Character training (use higgsfield-soul-id).
higgsfield-websites
higgsfield-ai/skills
Build, edit, and deploy full-stack websites, apps and games via the Higgsfield CLI (higgsfield website …). Each is a React 19 + TanStack Start SSR app in one Cloudflare Worker (D1/R2/KV/DO/Containers). THREE product types, picked via --type on create: website (standalone, no Higgsfield integration — references/website-flow.md), app (Sign in with Higgsfield + fnf SDK, Quanta — references/app-flow.md), game (realtime multiplayer rooms — references/game-flow.md). Routes to the right flow; each carries its own rules and deploy/publish gates. Use when: "build me a website", "make a landing page", "create a web app", "build a SaaS dashboard / portfolio", "make me a game", "deploy this site", "publish". Also owns GAME ART: "make a spritesheet", "tileable texture", "animate a 3D character", game music/SFX — see the game- references. NOT for: single image/video/audio generation (higgsfield-generate), product photos (higgsfield-product-photoshoot), marketplace cards (higgsfield-market
higgsfield-youtube-thumbnail
higgsfield-ai/skills
Create high-click-through YouTube thumbnails and vertical video covers through the Higgsfield CLI. Builds a truthful information-gap concept, preserves up to three referenced identities, supports logos and controlled variants, renders the main image with Nano Banana Pro, and applies focused Seedream edits. Use when: "make a YouTube thumbnail", "thumbnail for this video", "MrBeast-style cover", "Shorts cover", or "Instagram video cover". Chain after any video workflow once its truthful topic and visual direction are known. NOT for producing the video itself (use higgsfield-generate), product catalog photos (use higgsfield-product-photoshoot), or marketplace cards (use higgsfield-marketplace-cards).
Popular media & creative skills
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-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.
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.
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
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
ai-avatar-video
101-skills/superpowers
Create AI avatar and talking head videos via inference.sh CLI. Recommended: P-Video-Avatar (fastest, cheapest, built-in TTS). Also: OmniHuman, Fabric, PixVerse. Audio: Inworld TTS-2 (100+ languages, emotion steering for characters), ElevenLabs, Kokoro. Capabilities: audio-driven avatars, text-to-avatar, lipsync videos, talking head generation, virtual presenters, UGC content. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos, UGC ads, gaming avatars, NPC dialogue. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human, ugc, ugc video, ugc ad, avatar ugc