Higgsfield Brand Story

Higgsfield Brand Story Skill

What this skill does

Crafts production-ready brand story video prompts — origin stories, manifesto films, customer transformations, and behind-the-scenes narratives — and routes them to the best Higgsfield model for cinematic output. On request, it assembles the full parameter set, surfaces the credit cost, and — after explicit user confirmation — generates the asset via the opt-in generation flow. The skill also handles brand location and establishing stills via the soul_location still-image path.

Model routing

Primary and fallback video models

Routing rule: Use cinematic_studio_3_0 by default. Only fall back to veo3_1 when (1) the primary model is unavailable, or (2) the user wants native audio or explicitly photorealistic output and, after being informed of the trade-offs, accepts them: no 1:1 aspect ratio, discrete durations only (4/6/8 s instead of the continuous 4–15 s range), and start_image only (no end_image). Never switch silently.

MODEL-06 directive: If a parameter is rejected at generation time, call higgsfield:models_explore with the target model name to re-verify the live schema. The live catalog is the authoritative source. Full parameter tables: references/model-specs.md.

Per-platform aspect ratio quick rule

Vertical 9:16 for TikTok / Reels / Shorts; 16:9 for YouTube, LinkedIn, and website hero; 1:1 for Instagram feed square posts (cinematic_studio_3_0 only — veo3_1 has no 1:1). Full per-platform recommendation table: references/model-specs.md.

Still-image path (soul_location)

For brand location or establishing stills — a venue, storefront, workspace, or environmental brand moment — route to soul_location via higgsfield:generate_image.

• No tunable parameters — pass only aspect_ratio.
• Aspect ratios supported: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21.
• Workflow: After generating the still, pass the output image as a start_image reference to cinematic_studio_3_0 to carry the established location and atmosphere into video.

Full parameter table: references/model-specs.md.

Prompt-building workflow

1. Gather intent — Confirm with the user: brand story type (origin, manifesto, customer transformation, behind-the-scenes, etc.), emotional register (inspirational, warm/nostalgic, bold, calm/trustworthy), target platform, aspect ratio, desired duration, and whether native audio or a location still is needed.

2. Select model — Apply the routing table above. Use cinematic_studio_3_0 by default. Route location/establishing stills to soul_location. Select veo3_1 only when a routing trigger applies and the user has accepted the trade-offs.

3. Build the prompt — Use the craft principles and templates from the references:

   • Opening hook (2-second attention-capture) from references/hooks.md
   • Narrative arc, emotional register, camera/lighting, voiceover from references/narrative-craft.md
   • Worked example prompts by brand type from references/examples.md

4. Present for review — Show the assembled prompt and all parameters to the user for review and refinement before any generation call. The user must approve the prompt text, model, aspect ratio, and duration.

Opt-in generation

Generation costs Higgsfield credits and requires explicit user confirmation before any generate call is made. This skill never auto-generates.

Full step-by-step flow (confirmation gate, balance/cost surface, generate → poll → display): ../../shared/generation-flow.md

This skill's primary model: cinematic_studio_3_0

Media upload: Conditional — only when the user supplies a start_image or end_image reference for image-to-video. This skill is NOT a mandatory-I2V skill; T2V is the default path. When the user provides a reference image, run the higgsfield:media_upload → higgsfield:media_confirm atomic pair before generating.

Tool signatures: ../../shared/mcp-tools.md

Reference materials