shima.me

Serge Shima / Work and projects

visual-skills

AI film director skills for agents: cinematic dramaturgy (Murch, blocking, montage) + exact prompt syntax for Seedance 2.5, Kling 3.0 Turbo/Omni, Veo 3.1, Nano Banana 2, GPT Image 2.5.

Documentation and skills · 598 GitHub stars · Snapshot

GitHub · Full documentation · Project website

From the project documentation

An excerpt in the original language from the README. Current instructions, requirements and license are maintained in the repository.

En | Ru 🎬 Visual Skills — AI Film Director for Your Movie [](https://skills.sh/smixs/visual-skills) [](https://docs.claude.com/en/docs/agents/agent-skills) [](LICENSE) Two Claude Skills that turn your agent into a working film crew: `video` writes AI video prompts the way a director, screenwriter and editor would; `image` writes image prompts the way an art director would. Both pick the right model for the task, apply its exact syntax, and return a copy-paste-ready prompt. Most prompting guides teach you syntax. This one teaches your agent **cinema** — and that is what makes it the strongest tool available for directing AI video. Dramaturgy first, syntax second [!IMPORTANT] **Model syntax is worth nothing until the dramaturgy is there.** Editing, staging, camera, light, the objects allowed in frame — hard rules, all of them written into the skill. That is what makes it a director instead of an autocomplete for adjectives. Get them right and the model finally has something worth rendering; get them wrong and no amount of correct syntax saves the shot. The heart of the `video` skill is `video/references/dramaturgy.md` — how films are actually built, compressed into rules an agent can execute on a 5-30 second clip. Same idea, both columns below. Only one of them can be filmed. The prompt everyone writesfour adjectives, zero facts The prompt the skill writesone emotion · three shots · three details · one final image No desire, no obstacle, no geometry, no cut, no final image. The model picks all five for you — and picks differently on every run. Every line is a physical fact a camera could record: a reason for the move, a body carrying the emotion, a sound, an object, an ending. Nothing left for the model to invent. [!CAUTION] **Banned everywhere:** `cinematic` · `epic` · `stunning` · `masterpiece` · `beautiful lighting` · `dynamic camera` · `he is sad`. Each one is a placeholder for a detail the writer failed to invent, and not one of them renders. S E V E N   L A W S ,   N O N E   O P T I O N A L 0 1  ·  L A WThe scene formula desire + obstacle + geometry + gaze + rhythm Five elements. Name each one in a single sentence before a word of prompt is written: what the hero wants right now, what blocks it, who stands where, where the eye is forced to look, how long each shot lives. Anything less is decoration. 0 2  ·  D E T A I LThe Details Law Every shot owns three physical facts: one environmental pressure (cold refrigerator light, wet asphalt), one micro-action of the body (jaw locks, knuckles whiten), one sound anchor or visual motif. "He is sad" does not render. A jaw does. 0 3  ·  E D I T I N GWalter Murch's Rule of Six — where to cut, in priority order. Each item outweighs everything below it combined. emotion 51% █████████████████████████▌ story 23% ███████████▌ rhythm 10% █████ eye-trace 7% ███▌ screen plane 5% ██▌ 3D space 4% ██ Cutting "for pace" is item three. Serving item three ahead of emotion and story is exactly how TikTok mush gets made — and it is the default behaviour of every model you will ever prompt. 0 4  ·  S E L E C T I O NThe three-jobs rule A shot either changes emotion, advances action, or increases pressure. A shot that does none is deleted, however pretty it came out. "Beautiful establishing shot" is not a job. 0 5  ·  S T A G I N GBlocking, camera, environment Fincher — every camera move answers "what changed?", otherwise the camera is static. Spielberg — even in chaos the viewer knows where the hero, the threat and the exit are. Kurosawa — one weather, one pressure, carrying the whole scene. 0 6  ·  R H Y T H MMontage is a staircase long → shorter → shorter → pause → impact The pause before the hit matters more than the speed of the cuts. Beat maps for 15 / 30 / 60 / 90 seconds — Hook, Pressure, Crack, Impact, Aftermath. Never skip the Crack. 0 7  ·  S P E CThe shot card and the five anchors Fourteen fields per storyboard row: framing, composition, camera, movement reason, eye-trace, duration, cut type, sound, light. An empty field is missing direction. Per piece, exactly five anchors — one emotion, one motif, one object, one break, one final image. None of this is advice the agent is free to skip. `dramaturgy.md` loads before any model file, and the output is gated twice on the way out — the six-point dramaturgy check and a three-detail audit on every shot. A prompt that fails either one is not returned. Six-point check before any prompt leaves the skillscene formula  ·  three details  ·  three jobs  ·  motivated camera  ·  readable geometry  ·  five anchorsFail one, it does not ship.   →   read the full layer Supported models VIDEO · DEDICATED MODEL FILE, EXACT SYNTAX Seedance1.0 · 1.5 Pro · 2.0 · 2.0 Mini · 2.5 Kling1.6 – 2.6 Pro · 3.0 · Turbo · Omni Veo3 · 3.1 IMAGE · DEDICATED MODEL FILE, EXACT SYNTAX Nano Banana2 Lite · 2 · Pro (Gemini image family) GPT Image2.5 Flare · 2.5 Sunburst · legacy 2 COVERED BY THE UNIVERSAL-RULES LAYER Runway Gen-4    Luma    Pika    Sora Model files are updated as new versions ship — Seedance 2.5 has a dedicated production reference built from ByteDance's official guides of July 31, 2026 (30-second single-pass clips, 60s extension, 30-180s Ultra Long mode, 50 reference inputs, video editing, 3D camera blockout); Kling 3.0 Turbo and Omni and Nano Banana 2 Lite are already in. How the video skill works The `SKILL.md` body is a thin router; the craft lives in reference files the agent is forced to load in order:

Source retrieved · README 8ad4cc66425c

About the author

Serge Shima is co-founder and CTO of Majento in Tashkent and founder of Aimasters. He builds AI products and open-source tools for agents.

All repositories · github.com/smixs