Agent skill

Cinematic Motion Language

by alecs5am in alecs5am/ralphy

This skill provides the five-pillar language system for constructing video prompts with cinematic precision.

MITAuto-check passedMedia & Creative

Install Cinematic Motion Language

skills CLI
$ npx skills add alecs5am/ralphy --skill cinematic-motion-language -a claude-code

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

GitHub CLI
$ gh skill install alecs5am/ralphy cinematic-motion-language --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/alecs5am/ralphy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/notes/skills/cinematic-motion-language .claude/skills/cinematic-motion-language && 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
cinematic-motion-language
GitHub stars
138
Token cost
~1.9k tokens
SKILL.md length
993 words
Files
2 (incl. references)
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

This skill provides the five-pillar language system for constructing video prompts with cinematic precision.

  • Works in 4 steps: Motion Physics Anchor → Spatial Zoning → Lens Behavior Sequence → …
  • Tasks that involve AI video generation
  • SKILL.md covers Purpose, The Five Pillars, 2. Motion Physics Anchor and 3. Spatial Zoning, plus 14 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cinematic Motion Language is an agent skill from alecs5am/ralphy. This skill provides the five-pillar language system for constructing video prompts with cinematic precision. Apply it to any video generation task — atmosphere shots, product reveals, character scenes, abstract motion, sacred/spiritual visuals, or any brief where imprecise language would produce unpredictable results.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/implied-off-screen-motion.md`).

It sits in Media & Creative, covering AI video generation. The repository describes itself as: Open-source desktop app for content creation, with an agent runtime and standalone CLI. The licence is MIT.

When your agent uses it

  • Tasks that involve AI video generation

Example prompts

  • “/cinematic-motion-language”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Motion Physics Anchor
  2. Spatial Zoning
  3. Lens Behavior Sequence
  4. Negative Space as Compositional Tool

What it can do on your machine

Read from SKILL.md and the folder at commit 8d139f0. 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

Cinematic Motion Language loads about 1.9k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 86 tokens; SKILL.md has 993 words of instructions outside code blocks.

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

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 alecs5am/ralphy at commit 8d139f0, republished under its MIT licence (© alecs5am). 993 words, ~1,918 tokens.

Download SKILL.mdSave it as .claude/skills/cinematic-motion-language/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
cinematic-motion-language
description
This skill provides the five-pillar language system for constructing video prompts with cinematic precision. Apply it to any video generation task — atmosphere shots, product reveals, character scenes, abstract motion, sacred/spiritual visuals, or any brief where imprecise language would produce unpredictable results.
license
MIT

Cinematic Motion Language

Purpose

This skill provides the five-pillar language system for constructing video prompts with cinematic precision. Apply it to any video generation task — atmosphere shots, product reveals, character scenes, abstract motion, sacred/spiritual visuals, or any brief where imprecise language would produce unpredictable results.

The core principle: the model understands physics, geometry, sequence, and constraint — not adjectives. Replace every vague descriptor with a physical analogy, spatial coordinate, temporal sequence, or hard rule.

The Five Pillars

    1. Camera Contract

State the camera's behavior as a hard rule before describing anything else. The model treats the camera as a character — define it or it will improvise.

Examples:

  • "Static locked-off camera. Zero movement. No pan, no zoom, no dolly, no shake."
  • "Slow push-in only — 10% scale change over the full duration."
  • "Single handheld drift, slight organic sway, no cuts."
  • Always reinforce camera rules in the negative prompt as well.

2. Motion Physics Anchor

Give every moving element a speed reference from the physical world, not an adjective. Pair physical analogies with time-anchored measurements for maximum precision.

Speed analogy examples:

  • "like dust suspended in honey"
  • "like embers floating in still air"
  • "like smoke through a cathedral at dawn"
  • "like the surface of a lake disturbed by a single drop"

Time-anchored measurements:

  • "one full revolution across the entire 10-second clip"
  • "roughly 6 degrees per second"
  • "the pace of a clock's hour hand — imperceptibly slow"
  • "travels the full arc in 8 seconds with no pause"
  • Never use "slow", "fast", "gentle", "subtle" alone — always anchor to physics or time.

3. Spatial Zoning

Divide the frame into named regions and assign explicit rules to each. This prevents the model from filling empty space with invented content.

Region naming conventions:

  • "Left third / center third / right third"
  • "Foreground plane / midground / background"
  • "Upper half / lower half"
  • "Right two-thirds / left void"

Example zone rules:

  • "Left third: pure black, no light, no particles, no movement."
  • "Right two-thirds: all action contained here."
  • "Foreground plane: particle layer only — no subject."
  • "Background: unlit void, no detail."
  • Always cross-reference spatial zones in the negative prompt.

4. Lens Behavior Sequence

Describe focus and depth of field as a narrative event with a beginning, middle, and end. Models can simulate focus-breathing, rack focus, and lens diffusion — but only when the sequence is described explicitly as cause and effect.

Structure: trigger → shift → state → return → repeat

Example: "Focus opens on the subject. As the foreground element crosses the lens plane, focus shifts onto it — the subject softens into warm bokeh. The element drifts past. Focus breathes back to the subject. This cycle repeats organically 2-3 times."

Key lens vocabulary:

  • "shallow depth of field"
  • "focus-breathing" — organic in/out shift
  • "rack focus" — deliberate, directional shift between two subjects
  • "bokeh silhouette" — subject dissolves into soft out-of-focus warmth
  • "lens plane crossing" — the moment a foreground element passes between camera and subject
  • "anamorphic lens rendering" — oval bokeh, horizontal flare character, widescreen feel

5. Negative Space as Compositional Tool

Name empty areas of the frame as intentional design decisions, not absences. Then reinforce them in the negative prompt.

Examples:

  • "Sacred emptiness — the left third is a deliberate compositional weight."
  • "No light bleed into the dark half."
  • "The darkness is active, not background."
  • "Void occupies the left two-thirds — no fill, no ambient spill, no movement."

Negative prompt reinforcement:

  • "particles on the left side, light on the left side, movement on the left side"

The Prompt Template

Use this structure for every high-precision video brief:

CAMERA: [static / push / drift / handheld — state as a hard rule] ASPECT RATIO: [21:9 / 16:9 / 9:16] DURATION: [X seconds]

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

Style & Mood: [visual register + atmosphere in one line]

Narrative: [one sentence — what happens]

Action:

  • Subject: [who/what, position in frame, emotional state]
  • Motion: [speed anchor — physical analogy + time measurement]
  • Secondary motion: [particles / fabric / smoke — own speed anchor]

Lens:

  • Focal feel: [wide / normal / telephoto character]
  • Focus event: [cause → shift → state → return → repeat count]
  • DoF: [shallow / deep / breathing]

Lighting: [source count, direction, quality, color temperature]

Spatial Zones:

Audio: [sound texture description — not music genre]

Quality suffixes: [photoreal, film grain, anamorphic, 8K detail, etc.]

Negative Prompt: [camera moves, spatial violations, style rejections, motion violations]

Key Vocabulary Reference

Camera static locked-off / handheld drift / slow push-in / crane reveal / whip pan / zero movement / no reframe / locked composition

Motion Speed

suspended in honey / floating in still air / cathedral smoke / hour-hand pace / imperceptibly slow / continuous fluid arc / no acceleration / no stillness

Particle Behavior

three-dimensional spiral / orbiting / foreground crossing / contained within zone / rising and descending in soft arcs / catching directional light / swirling behind and around

Lens / Focus

shallow depth of field / focus-breathing / rack focus / bokeh silhouette / lens plane crossing / anamorphic rendering / focus returns organically / sharp foreground — soft midground — void background

Lighting

single key light / directional warm / chiaroscuro / golden-amber / deep shadow / no fill / no ambient spill / upper right source / rim light / backlight halo

Negative Space

sacred emptiness / pure black void / no light bleed / no particles / no movement / deliberate compositional weight / active darkness

Advanced Techniques

references/implied-off-screen-motion.md: How to choreograph limbs/props moving through a locked frame to imply a body rotating or moving outside the camera's view. Worked Example — Dervish Shot Brief: Whirling dervish, close-up of raised hand and forearm, golden dust particles, pure black left third, sacred Sufi atmosphere.

Camera: Static locked-off. Zero movement. No pan, no zoom, no dolly.

Motion anchor: Hand traces the arc of one full Sama rotation over 10 seconds — the pace of a clock's hour hand. Particles move like embers in still air.

Lens event: Foreground particles cross lens plane → focus shifts to particles (sharp, glowing) → hand softens to warm bokeh → particles drift past → focus returns to hand. Cycle repeats 2-3 times organically.

Spatial zones:

  • Left third: pure black, no particles, no light, no movement.
  • Right two-thirds: all motion contained here.
  • Foreground plane: particle layer, passes in front of hand.
  • Lighting: Single warm key from upper right. Deep chiaroscuro. Golden-amber on black.

Negative prompt: camera movement, pan, zoom, dolly, shake, fast motion, fast particles, particles on the left side, light on the left side, acceleration, abrupt cuts, cartoon, anime, strobing.

© alecs5am, 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 1 other file (references) in notes/skills/cinematic-motion-language of alecs5am/ralphy.

  • SKILL.md
  • references/implied-off-screen-motion.md

Open the folder on GitHubat commit 8d139f0

Compare with similar skills

Cinematic Motion Language 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.

Cinematic Motion Language compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cinematic Motion Language this skillalecs5am/ralphy138—~1.9kAutomated safety check: PassMIT
Video Generationbytedance/deer-flow84k3 repos~1.4kAutomated safety check: PassMIT
Video Cover Imageitwanger/toBeBetterJavaer18k—~3.3kAutomated safety check: PassNone
Seedancesongguoxs/seedance-prompt-skill2.9k1 repos~2.5kAutomated safety check: PassNone
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0
Lanshu Create AI Presenter Videocclank/lanshu-create-ai-presenter-video2.6k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Video Generation

    bytedance/deer-flow

    Generates short videos from a structured JSON prompt, optionally guided by a reference image used as the first or last frame.

    84k GitHub starsUsed in 3 repos~1.4k tokens
    Media & CreativeAuto-check passed
  • Video Cover Image

    itwanger/toBeBetterJavaer

    Generate matched 3:4, 16:9, and 4:3 short-video cover images from toBeBetterJavaer video scripts or AI/Java technical topics.

    18k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Seedance

    songguoxs/seedance-prompt-skill

    This skill should be used when the user asks to "generate video prompts", "create Seedance prompts", "write video descriptions", mentions "Seedance", "seedance", "即梦", "即梦平台", "视频提示词", "视频生成"…

    2.9k GitHub starsUsed in 1 repo~2.5k 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
  • Lanshu Create AI Presenter Video

    cclank/lanshu-create-ai-presenter-video

    Turn a topic or finished script into a complete, publish-ready explainer video — led by an AI presenter from an authorized adult presenter image, or performed in one of nine visual explainer styles…

    2.6k GitHub stars~3.6k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Video Shots

    eternityspring/reelbench-skills

    拉片:把一条成片拆成逐镜头的分析表——每个镜头的时长、景别、类别、运镜、画面. An agent skill from eternityspring/reelbench-skills.

    878 GitHub starsUsed in 1 repo~1.8k tokens
    Media & CreativeAuto-check: notes

More from alecs5am/ralphy

All 28 skills in this repo
  • Gsap

    alecs5am/ralphy

    GSAP animation reference for HyperFrames. An agent skill from alecs5am/ralphy.

    138 GitHub stars~2.4k tokensUpdated 17 days ago
    Auto-check passed
  • Researcher

    alecs5am/ralphy

    Deep-research workflow for UGC reference material — turns one or more URLs / handles / trend queries into a single cited research report (report.md + sources.json) that a scenarist or art-director…

    138 GitHub stars~1.9k tokensUpdated 17 days ago
    Auto-check passed
  • Editor

    alecs5am/ralphy

    Composition and render craft — assembles scenario.json plus asset-manifest.json into a HyperFrames HTML composition and renders the mp4.

    138 GitHub stars~3.6k tokensUpdated 17 days ago
    Auto-check passed
  • Evaluator

    alecs5am/ralphy

    Quality evaluation of rendered UGC mp4s — scene segmentation, audio loudness / dead-air, caption density, and per-scene visual analysis.

    138 GitHub stars~3.6k tokensUpdated 17 days ago
    Auto-check passed
  • Producer

    alecs5am/ralphy

    End-to-end orchestration — the wrapper that drives the whole production contract across roles, plus batch production.

    138 GitHub stars~4.7k tokensUpdated 17 days ago
    Auto-check passed
  • Scenarist

    alecs5am/ralphy

    Scenario and script craft — writes and reworks the scene-by-scene scenario.json: hook, beat structure, per-scene VO, on-screen text, pacing, and the language/aspect pre-flight.

    138 GitHub stars~3.2k tokensUpdated 17 days ago
    Auto-check passed

Questions about Cinematic Motion Language

What does Cinematic Motion Language do?

This skill provides the five-pillar language system for constructing video prompts with cinematic precision. Cinematic Motion Language is an agent skill from alecs5am/ralphy. This skill provides the five-pillar language system for constructing video prompts with cinematic precision.

When should I use Cinematic Motion Language?

Cinematic Motion Language fits situations like: tasks that involve AI video generation.

How do I install Cinematic Motion Language in Claude Code?

Run `npx skills add alecs5am/ralphy --skill cinematic-motion-language -a claude-code`. Or copy the skill folder (notes/skills/cinematic-motion-language in alecs5am/ralphy) into .claude/skills/cinematic-motion-language in your project. Claude Code loads it when a task matches its description.

How do I install Cinematic Motion Language in Codex?

Run `npx skills add alecs5am/ralphy --skill cinematic-motion-language -a codex`. Or copy the skill folder (notes/skills/cinematic-motion-language in alecs5am/ralphy) into .agents/skills/cinematic-motion-language in your project. Codex loads it when a task matches its description.

Can I use Cinematic Motion Language 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 alecs5am/ralphy --skill cinematic-motion-language -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cinematic-motion-language, .gemini/skills/cinematic-motion-language, .github/skills/cinematic-motion-language and .opencode/skills/cinematic-motion-language in your project.

What does Cinematic Motion Language need to run?

SKILL.md names no scripts, command-line tools or credentials: Cinematic Motion Language is instructions for the agent only.

Does Cinematic Motion Language 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 Cinematic Motion Language 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 Cinematic Motion Language use?

Cinematic Motion Language is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cinematic Motion Language use?

About 1.9k tokens (SKILL.md is roughly 7.7k 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 371 tokens, read only when the agent opens those files.

What are the alternatives to Cinematic Motion Language?

Skills that share tags, products or a category with Cinematic Motion Language: Video Generation (bytedance/deer-flow, 84k stars), Video Cover Image (itwanger/toBeBetterJavaer, 18k stars), Seedance (songguoxs/seedance-prompt-skill, 2.9k stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cinematic Motion Language?

alecs5am (a GitHub user) maintains it in alecs5am/ralphy, which has 138 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 22, 2026.

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