| 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
- ai-video — the model-agnostic router/craft above the video tools.
- 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.
