
benjiyaya/ltx-2.5-agent-prompt-skill
Developer toolsA Hermes Agent skill that transforms rough video ideas + reference images/audio into production-grade (Lightricks) video generation prompts.
Overview
A Hermes Agent skill that transforms rough video ideas + reference images/audio into production-grade (Lightricks) video generation prompts. Unlike structured-format skills (e.g., MiniMax H3), LTX 2.5 prompting is — one flowing cinematic paragraph that reads like a shot description for a cinematographer. No JSON, no field labels, no tags. Just prose. When you describe a video concept (with or without attached media), this skill: 1. — single-shot, multishot (NEW in 2.5), or screenplay-style 2. your idea across 6 cinematic dimensions 3. — ready to paste into ComfyUI or LTX Studio ⭐ Previous versions only produced a single continuous shot. Now you can generate 2–4 connected shots — holding character identity, environment, lighting, and voice across cuts — all from one prompt. Every prompt integrates these elements in order (models weight earliest tokens more heavily): 1. 🎥 — Cinematography terms, shot scale, angle, style markers 2.
README
🎬 LTX 2.5 Video Prompt Agent Skill
A Hermes Agent skill that transforms rough video ideas + reference images/audio into production-grade LTX 2.5 (Lightricks) video generation prompts.
Unlike structured-format skills (e.g., MiniMax H3), LTX 2.5 prompting is pure natural language — one flowing cinematic paragraph that reads like a shot description for a cinematographer. No JSON, no field labels, no tags. Just prose.
What It Does
When you describe a video concept (with or without attached media), this skill:
- Detects the mode — single-shot, multishot (NEW in 2.5), or screenplay-style
- Creatively enhances your idea across 6 cinematic dimensions
- Outputs a natural-language prompt — ready to paste into ComfyUI or LTX Studio
LTX 2.5 Modes
| Mode | Use Case | Output Format |
|---|---|---|
| Single-Shot | One continuous take (T2V, I2V, A2V, V2V) | Flowing paragraph, 4–8 sentences |
| Multi-Shot ⭐ | Multiple connected cuts in one generation | Chronological prose with named transitions |
| Screenplay-Style | Dialogue-heavy scenes with character cues | Screenplay scene with acting directions |
⭐ Native multishot is the headline feature of LTX 2.5. Previous versions only produced a single continuous shot. Now you can generate 2–4 connected shots — holding character identity, environment, lighting, and voice across cuts — all from one prompt.
The 6-Part Prompt Structure
Every prompt integrates these elements in order (models weight earliest tokens more heavily):
- 🎥 Establish the Shot — Cinematography terms, shot scale, angle, style markers
- 💡 Set the Scene — Lighting, color palette, textures, atmosphere
- 🏃 Describe the Action — Core action as a flowing sequence, present tense
- 👤 Define Character(s) — Physical specifics, wardrobe, emotion via physical cues
- 📷 Camera Movement — How and when the camera moves, relative to subject
- 🔊 Describe the Audio — Ambient sound, action SFX, music, dialogue
Important: This structure is a mental model for the writer. The output is pure prose — the model never sees field labels or numbered sections.
Installation
For Hermes Agent Users
Copy the skill folder to your Hermes skills directory:
# Linux/macOS
cp -r ltx-2-5-prompter ~/.hermes/skills/creative/
# Windows
xcopy ltx-2-5-prompter %LOCALAPPDATA%\hermes\skills\creative\ /E /I
Restart Hermes Agent. The skill auto-triggers when you mention LTX, attach media, and describe a video idea.
For Other Agent Frameworks (Claude, Codex, etc.)
The SKILL.md and reference files are standard Markdown — load them as system context or project rules in any agent that supports file-based instructions.
File Structure
ltx-2-5-prompter/
├── README.md # You are here
├── SKILL.md # Main skill — workflow, rules, verification
└── references/
├── single-shot-format.md # Default mode — one continuous take
├── multishot-format.md # NEW 2.5 feature — connected cuts in one prompt
├── screenplay-format.md # Dialogue-heavy scenes with character cues
├── creative-examples.md # Weak→strong transformations + advanced patterns
└── ltx-vocabulary.md # 100+ categorized cinematic terms
Usage Examples
Single-Shot (Text-to-Video)
💬 "A golden retriever running through a sunny meadow"
→ The skill enhances this into:
Wide tracking shot of a golden retriever sprinting through a sunlit wildflower meadow, golden hour light catching the fur, lens flares from the low sun, camera follows at ground level alongside the dog, shallow depth of field with wildflowers blurring in the foreground. The sound of padded footsteps on grass, distant birdsong, and a warm breeze rustling the flowers.
Multi-Shot (NEW in 2.5)
💬 "A woman in a raincoat waiting for someone at a rainy intersection,
then we see the person arriving — multishot"
→ The skill produces a chronological paragraph with named cuts, audio continuity, and character re-identification at each transition. 2–4 shots, each with a clear job (establish → detail → reaction).
Screenplay-Style (Dialogue Scene)
💬 "A news reporter discovering oil has been found in a small town,
live broadcast format"
→ The skill formats the scene with INT./EXT. headers, character cues, physical acting directions between dialogue beats, and camera/audio notes woven throughout.
Weak → Strong Transformation
| Weak Prompt | Why It Fails | Strong Prompt |
|---|---|---|
| “A nice cinematic video of a person walking” | No shot type, no lighting, no character, no camera, no audio — “nice” and “cinematic” carry no signal | “Wide tracking shot of a young courier in a rain shell walking briskly through a Shibuya backstreet at 6pm, warm sodium streetlights reflecting on wet asphalt, camera dollies alongside at hip height, shallow depth of field, documentary look on 35mm” |
| “A sad man talks about his family” | “Sad” is an abstract label the model can’t render | “A middle-aged man with greying hair speaks in a slow-paced voice, pauses, looks to the side, voice cracking — eyes widening momentarily” |
| “A product shot of a bottle” | Zero specificity | “Close-up product shot of a brushed-steel water bottle on bone-white marble, slow 20-degree camera arc, soft key light top-left, matte-black backdrop, high-end commercial aesthetic” |
What’s New in LTX 2.5 (vs 2.3)
| Feature | LTX 2.3 | LTX 2.5 |
|---|---|---|
| Multishot | Single continuous shot only | Native multishot (2–4 connected cuts) ⭐ |
| Text Encoder | T5-based | Custom Gemma 4 12B (holds more detail) |
| Video Decoder | Standard VAE | Diffusion video decoder (sharper faces/text) |
| Prompt Enhancer | Not built-in | Built-in, auto-expands short prompts |
| Duration | Manual frame count | Optional auto-predict from prompt |
| Rendering | Fixed compression | Diffusion Fidelity (dynamic compute) |
| Resolution | Up to ~1080p | Native 4K HDR + RAW pipeline |
| Artifacts | 0.74 (Pro score) | 0.28 (2.6× improvement) |
| Speed | Slower | 6.8s on-prem (10s I2V clip) |
| Parameters | 22B DiT | 22B DiT (same — everything else is new) |
| License | Open, free < $10M ARR | Same |
Key Prompting Principles
- Natural language, not tags — LTX reads prose like a cinematographer reads a shot description
- One action per shot — never cram multiple actions; split across shots or generations
- Physical cues, not emotional labels — “eyes widen, voice cracking” not “sad”
- Named references, not vague qualifiers — “shot on 35mm, documentary look” not “cinematic”
- Match length to duration — short prompts for long videos leave the model without direction
- One coherent light source — mixed lighting confuses scene interpretation
- Always describe audio — LTX 2.5 generates synced audio natively
- Present tense throughout — “walks” not “walked”
Multishot Transition Vocabulary
| Transition | When to Use | Example Phrasing |
|---|---|---|
| Hard cut | Abrupt, most common | “A hard cut transitions to…” |
| Match cut | Visually similar compositions | “A match cut connects…” |
| Dissolve | Gradual blend, time passage | “The image dissolves into…” |
| Jump cut | Temporal leap | “A jump cut leaps to…” |
| Fade | Through black/white | “The scene fades to black, then reveals…” |
At every cut, state: new framing, who’s in frame (re-identified), and audio continuity (“the score continues across the cut” or “the music drops; only wind remains”).
Technical Constraints (LTX 2.5)
- Frame count:
num_frames % 8 == 1(1, 9, 17, 25, …, 121, …) - Resolution: Width and height divisible by 32
- Distilled model: Fixed 8-step schedule, CFG=1
- Auto-duration: Omit
--num-framesto let the duration head predict clip length - VRAM: 16GB minimum (int8 convrot), 24GB+ recommended (bf16)
- Spatial upscaler: LTX 2.3 spatial upscaler still required for Stage 2
Sources & References
- LTX 2.5 Model Page — Official features and benchmarks
- LTX 2.5 HuggingFace — Model card, weights, code samples
- LTX 2.5 Prompt Guide — Official prompting guide
- LTX 2.3 Prompt Guide — Previous version reference
- AI Video Prompt Guide — General 6-part structure
License
MIT — use freely. The LTX 2.5 model weights themselves are under the LTX-2.x Community License (free for organizations under $10M ARR).
Author
Benji AI Playground — YouTube · GitHub
In-depth technical AI video content. H3, LTX, SeeDance pipelines and workflows.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add benjiyaya/ltx-2.5-agent-prompt-skill