--- 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.