seedance-minimax-prompts

---
name: seedance-minimax-prompts
description: >
  Router for AI video generation prompt skills in the seedance-minimax-prompts
  repository. Use when the user wants video generation prompts or generation requests
  for ByteDance Seedance 2.5 (text-to-video, image-to-video, video-extension,
  video-edit) or MiniMax H3 / Hailuo (text-to-video, first-frame, last-frame,
  first-last-frame, Ref2VA). Routes to the per-model skills, explains the unified
  VideoProjectSpec -> route() -> compiler flow, and enforces hard facts: MiniMax H3
  duration 4-15 s, Seedance 2.5 up to 30 s per generation with at most two
  extensions, third-party claims never presented as official, no claim of an
  official SDK, a complete local open-source H3 2K pipeline, or native 4K Seedance.
---

# AI Video Director Skills — Router

This is the entry-point skill of the `seedance-minimax-prompts` repository:
a neutral, open-source director layer for AI video generation prompts. It is not
an official ByteDance or MiniMax product, not an SDK, and not a model hosting
service.

## When to use

Use this skill when the user asks for video generation prompts, prompt writing, or
generation requests targeting one of these models:

- **Seedance 2.5** (ByteDance) — modes: `text-to-video`, `image-to-video`,
  `video-extension`, `video-edit`.
- **MiniMax H3** (Hailuo) — modes: `text-to-video`, `first-frame`, `last-frame`,
  `first-last-frame`, `ref2va`.

Do not use it for other models, for pure image generation, or for content with
unlicensed/movie/TV/brand assets.

## Routing

1. Determine the target model from the user's request or from
   `spec["model"]` (`"seedance-2.5"` or `"minimax-h3"`).
2. Load the matching sub-skill and follow it:

   - `skills/seedance-2.5/SKILL.md` (skill name: `seedance-2.5`)
   - `skills/minimax-h3/SKILL.md` (skill name: `minimax-h3`)

3. Read the model's grammar before writing a prompt:

   - `models/seedance-2.5/prompt-grammar.md`
   - `models/minimax-h3/prompt-grammar.md`

## How to use the compiler

Do not hand-roll prompts. Build a `VideoProjectSpec` dict conforming to
`schemas/video-project.schema.json`, then route it:

```python
from ai_video_director.router import route

request = route(spec)              # validates spec + per-model constraints
prompt = request["prompt"]         # model-specific, grammar-compliant prompt
```

Flow: `validate_spec()` (schema + hard constraints) -> `route()` (pick compiler by
`spec["model"]`) -> model-specific `compile()` -> `validate_generation_request()`.
Compilers live in `src/ai_video_director/compilers/seedance_25.py` and
`src/ai_video_director/compilers/minimax_h3.py`. Violations raise
`ai_video_director.validators.ValidationError`; nothing is silently clamped.

## Hard rules

- **Duration caps are hard.** MiniMax H3: 4-15 s only (open weights and API).
  Seedance 2.5: up to 30 s per single generation; longer timelines use the
  official `video-extension` flow with at most two extensions, each extension its
  own generation within the cap. Never clamp, round, or silently adjust a duration.
- **Never present third-party claims as official.** Claims that appear only in
  third-party wrappers — native 4K Seedance, 72 API routes, relaxed moderation,
  specific pricing or endpoints — must be attributed to that provider or omitted.
- **Never claim**: an official SDK (official surfaces are product pages, the API
  and the open-source repo), a complete local open-source H3 2K pipeline
  (H3-Context-IR and H3-Regenerate-2K are not open-sourced; local H3-Base outputs
  768p, 2K requires the official API), or native 4K Seedance output.
- **Ref2VA limits are hard:** up to 9 images, 3 videos, 3 audio, 12 files total;
  each reference video/audio clip 2-15 s, total reference duration <= 15 s.
- **No model capability inheritance.** A mode or limit from one model is never
  assumed valid for the other. Model modes are per-model: Seedance 2.5
  `text-to-video` / `image-to-video` / `video-extension` / `video-edit`; MiniMax H3
  `text-to-video` / `first-frame` / `last-frame` / `first-last-frame` / `ref2va`.
- **Audio intent is always written** into the prompt: both models are audio-video
  joint generation (Seedance 2.5 official; H3 native 32 kHz stereo).

## Where evidence lives

- Capability facts: `models/<model-id>/capability.yaml` and `constraints.yaml`
  (every entry carries `evidence_level`, `checked_at`, `source_url`, `surface`).
- Source registry: `sources/official-sources.yaml` (official only) and
  `sources/third-party-providers.yaml` (third-party, kept separate).
- Human-readable registry and licensing verdict: `THIRD_PARTY_SOURCES.md` and
  `docs/license-audit.md`.
- Facts checked on 2026-08-19; when re-verifying, update `checked_at` and
  `source_url` together.