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…

MITAuto-check passedMedia & Creative

Install Luma

skills CLI
$ npx skills add social-media-skills/skills --skill luma -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install social-media-skills/skills luma --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/luma .claude/skills/luma && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
luma
GitHub stars
134
Token cost
~2.1k tokens
SKILL.md length
910 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 2 steps: ai-video — the model-agnostic… → brand-profile + design-and-templates…
  • Someone wants to generate video with Luma/Dream Machine/Ray3
  • SKILL.md covers The POV: shots, not films —…, Read these first, The framework: DREAM and The reality (verify-quarterly), plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Luma is an agent skill from social-media-skills/skills. 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 +…

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `evals/evals.json`, `references/luma-2026-reality.md` and `references/scope-and-connections.md`).

It sits in Media & Creative, covering AI video generation. It works with Google Veo and HeyGen. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Someone wants to generate video with Luma/Dream Machine/Ray3
  • Animate a still into video
  • Keep a character consistent across shots
  • Restyle real footage

Example prompts

  • “/luma”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

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

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Luma loads about 2.1k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 245 tokens; SKILL.md has 910 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~245
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 910 words, ~2,104 tokens.

Download SKILL.mdSave it as .claude/skills/luma/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
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.

Show full SKILL.md (365 more words)Show less

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.

© social-media-skills, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/luma of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/luma-2026-reality.md
  • references/scope-and-connections.md
  • references/shot-patterns-and-templates.md
  • references/the-dream-framework.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Luma next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Luma compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Luma this skillsocial-media-skills/skills134—~2.1kAutomated safety check: PassMIT
Video Shortformsanqiufong/slides-from-anything1321 repos~1.1kAutomated safety check: PassApache-2.0
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0
Avatar Videocalesthio/OpenMontage66k—~1.6kAutomated safety check: PassAGPL-3.0
Create Videocalesthio/OpenMontage66k—~1.3kAutomated safety check: PassAGPL-3.0
Super Video MakerBomx/super-video-maker-skill310—~11kAutomated safety check: NotesNone

Similar skills

  • Video Shortform

    sanqiufong/slides-from-anything

    Short-form video generation skill — 3-10 second clips for product reveals, motion teasers, ambient loops.

    132 GitHub starsUsed in 1 repo~1.1k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Avatar Video

    calesthio/OpenMontage

    Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API.

    66k GitHub stars~1.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Create Video

    calesthio/OpenMontage

    Create videos from a text prompt using HeyGen's Video Agent.

    66k GitHub stars~1.3k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Super Video Maker

    Bomx/super-video-maker-skill

    End-to-end AI video production skill for agentic frameworks.

    310 GitHub stars~11k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Video

    Nexus-JPF/note-companion

    When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks.

    870 GitHub starsUsed in 3 repos~3.6k tokens
    Media & CreativeAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Questions about Luma

What does Luma do?

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…. Luma is an agent skill from social-media-skills/skills. 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.

When should I use Luma?

Luma fits situations like: someone wants to generate video with Luma/Dream Machine/Ray3; animate a still into video; keep a character consistent across shots; restyle real footage.

How do I install Luma in Claude Code?

Run `npx skills add social-media-skills/skills --skill luma -a claude-code`. Or copy the skill folder (skills/luma in social-media-skills/skills) into .claude/skills/luma in your project. Claude Code loads it when a task matches its description.

How do I install Luma in Codex?

Run `npx skills add social-media-skills/skills --skill luma -a codex`. Or copy the skill folder (skills/luma in social-media-skills/skills) into .agents/skills/luma in your project. Codex loads it when a task matches its description.

Can I use Luma in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add social-media-skills/skills --skill luma -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/luma, .gemini/skills/luma, .github/skills/luma and .opencode/skills/luma in your project.

What does Luma need to run?

SKILL.md names no scripts, command-line tools or credentials: Luma is instructions for the agent only. Our summary lists: Python 3.

Does Luma access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Luma safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Luma use?

Luma is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Luma use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Luma?

Skills that share tags, products or a category with Luma: Video Shortform (sanqiufong/slides-from-anything, 132 stars), HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars), Avatar Video (calesthio/OpenMontage, 66k stars) and Create Video (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Luma?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

Source: social-media-skills/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.