luma — Claude Code skill for Luma Dream Machine video generation

---
name: luma
description: >-
  The Luma Dream Machine craft skill — generate cinematic AI video shots (Ray3: text-to-video,
  image-to-video, keyframes, character reference, Modify V2V, HDR) with draft-first economics and
  the right rights. Use when someone wants to generate video with Luma/Dream Machine/Ray3, animate
  a still into video, keep a character consistent across shots, restyle real footage, control
  credit burn, pick a Luma model or plan, or build a multi-shot AI brand film. Uses the DREAM
  framework. Reads ai-video + brand-profile + short-form-video-script first. The agent writes shot
  briefs and can drive the API where connected; the HUMAN judges every clip; WoopSocial publishes.
  Generations are shots not films (no native audio); Draft Mode first, HDR only for finals; verify
  tiers in-app. Never use unpermitted likeness, generate fake-event footage, or state credit rates
  as fact. Distinct from ai-video, veo-3/kling/runway, flux (the stills this animates),
  heygen/synthesia, and capcut.
version: 1.0.0
---

# luma

The **cinematic video-generation tool skill** — define the shot, reference with stills + frames, economize with
drafts, assemble the sequence, and mind the rights. The agent briefs (and can drive the API where connected);
the **human judges every clip**; **WoopSocial publishes**. (Ships with `tools/integrations/luma.md`.)

## The POV: shots, not films — and drafts, not gambles
Dream Machine's 2026 edge is per-shot cinematic quality: Ray3 was the first "reasoning" video model (it
interprets, generates, self-evaluates, retries), with 16-bit HDR, keyframes, character reference, and Modify
(restyle real footage, keep the performance). The top-1% operator holds four truths the marketing softens.
**(1) Generations are shots, not films:** 5–10 seconds each, Extend degrades past the initial clip — a brand
film is a shot list, generated shot-by-shot and **assembled in an editor** with **sound added in post** (no
native audio; that's Veo/Kling territory). **(2) Draft first, always:** iterate cheap in Draft Mode, Hi-Fi
master only the winner — because HDR at 1080p runs ~16× standard credits and monthly credits expire at reset.
**(3) Variance is real:** the same prompt differs run-to-run more than half the time (independent testing) — so
client-grade consistency comes from **references** (still-first image-to-video, character reference on base
Ray3, keyframes), never from luck. **(4) The rights fine print:** free = watermarked non-commercial, the
commercial floor is the Plus-level plan (tier tables genuinely conflict — verify in-app), and **Luma keeps a
marketing license on your generations** — the clause client work needs to know about.

## Read these first
1. **ai-video** — the model-agnostic router/craft above the video tools.
2. **brand-profile** + **design-and-templates** (the brand feel) + **short-form-video-script** (the beats).

## The framework: DREAM
(Depth: `references/the-dream-framework.md`.)
- **D — Define the shot:** a director's shot brief (subject + action + setting + light + mood + camera move);
  one shot per generation; vague prompts pay the variance tax.
- **R — Reference with stills + frames:** still-first image-to-video (brand-true frames from flux/Photon);
  keyframes for transitions; character reference (Ray3) for identity; Modify for real footage; never an
  unpermitted likeness.
- **E — Economize with drafts:** Draft Mode → Hi-Fi the winner; ~3 attempts per usable clip budgeted; HDR only
  for graded finals; credits expire — plan sessions.
- **A — Assemble the sequence:** shots → capcut (pace to the beats), sound in post (ai-music-and-sound),
  keyframe-matched cuts; drift review on sets.
- **M — Mind the rights:** commercial tier confirmed; Luma's license-back understood (Enterprise for NDA);
  AI-disclosure (EU AI Act; C2PA); then the human judges and WoopSocial publishes.

## The reality (verify-quarterly)
2026 Luma: **Ray3** (reasoning model; 16-bit HDR + EXR; keyframes; character reference; visual annotation;
Modify V2V) · **Ray3.14** (Jan 2026 — native 1080p, ~4× faster, ~3× cheaper at 720p; **drops character
reference + HDR**) · a newer Ray already on the official pricing page (the line moves) · **Photon** (images) ·
**Luma Agents** (multi-model bundle incl. Veo/Kling/ElevenLabs — worth it if you'd pay for 2–3 bundled models;
overpaying for one) · official Python SDK (create → poll → download); **API credits are a separate wallet.**
Economics: Draft→Hi-Fi is the signature workflow; HDR 1080p ≈ 16× standard 720p; ~3 attempts/usable clip;
monthly credits expire, top-ups roll over; Trustpilot skews negative on billing. Rights: free = non-commercial;
commercial floor = Plus-level (~$30/mo; **tier tables conflict — two plan generations coexist; verify
in-app**); Luma's marketing license-back; Enterprise = data-privacy guarantee. Variance: same prompt differs
>50% of runs (goenhance). Sora's consumer shutdown (Apr 2026) made Luma a migration target. **Attribute all;
verify-quarterly.** Full detail: `references/luma-2026-reality.md`. The model table, shot-brief pattern, the
sequence workflow, the credit worksheet, and two worked examples: `references/shot-patterns-and-templates.md`.

## Honest scope (never violate)
- **The agent** briefs shots, plans references/keyframes/credits, and drives the SDK **where connected** (exact
  human steps otherwise; no unreviewed auto-publish); the **human judges every clip** (no fabricated "that shot
  works"; drift reviews on sets); **WoopSocial publishes** the exports — it does **not** generate or edit video.
- **Rights spine:** free tier never for client/commercial work; verify the current tier in-app; Luma's
  license-back disclosed to clients where relevant; Enterprise for NDA; counsel for high-stakes (not legal
  advice). **Likeness/misinformation:** no unpermitted real-person likeness (real or AI lookalike); **no
  photoreal fake-event footage of real entities** ("satire" doesn't launder defamation); **AI-disclosure** where
  required. **Sound in post** with proper licenses. **Never fabricate** rates, tiers, benchmarks, capabilities.
  (Full scope: `references/scope-and-connections.md`.)

## Distinct from its siblings (route correctly)
**luma (this)** = the Dream Machine lane (cinematic shots, HDR, references, Modify) · **ai-video** = the
model-agnostic router (read first) · **veo-3 / kling / runway** = sibling skills (runway = the control-focused/edit-grade lane) — **sound-native generation routes to
Veo/Kling** (Luma = silent + post) · **flux / image-prompt** = the brand-true stills this animates · **heygen /
synthesia** = avatar presenters (a different job) · **capcut** = where shots become films ·
**ai-music-and-sound** = the audio Luma doesn't generate.

## Where this connects
Reads first: **ai-video** + **brand-profile** + **design-and-templates** + **short-form-video-script.** Pulls
stills from: **flux / image-prompt.** Feeds: **capcut** (assembly), **ai-music-and-sound** (audio), **tiktok-
video-publishing / instagram-reels-publishing / youtube-shorts** (the finished clip). Publishes via: export →
**scheduling-and-queue → WoopSocial.** Tool file: **`tools/integrations/luma.md`.** Measure with: native +
**analytics-and-reporting** — never fabricated.

## Definition of done
A Luma workflow that ships shots on-budget and on-rights: every generation briefed as a director's shot (one
shot, concrete subject/action/light/camera), brand control achieved still-first (image-to-video from canonical
flux/Photon frames; character reference on Ray3 for identity; keyframes for transitions; Modify for real
footage; no unpermitted likeness), credits governed by the draft-first loop (Draft iterations → one Hi-Fi
master; HDR reserved for graded finals; ~3-attempt budget; sessions planned around expiring credits; API wallet
funded separately where used), sequences assembled in capcut to the script's beats with licensed sound added in
post and a side-by-side drift review, and rights closed before publishing (commercial tier verified in-app;
Luma's license-back known; AI-disclosure where required; no fake-event footage of real entities); the human
judging every clip and WoopSocial publishing the finished file; **no fabricated rates/tiers/benchmarks, no
one-generation "film" promises**; and correctly distinguished from ai-video, veo-3/kling, flux,
heygen/synthesia, and capcut.