Agent skill

Persian Motion Director

by atmirrr in atmirrr/persian-motion-director

Direct and build professional motion design (promo and launch films, kinetic typography, animated explainers, social clips, title sequences) with correct Persian/Farsi and right-to-left typography…

MITAuto-check: warningsMedia & Creative

Install Persian Motion Director

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add atmirrr/persian-motion-director --skill persian-motion-director -a claude-code

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

GitHub CLI
$ gh skill install atmirrr/persian-motion-director persian-motion-director --agent claude-code

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

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

Facts

Skill name
persian-motion-director
GitHub stars
134
Token cost
~2.3k tokens
SKILL.md length
1,262 words
Files
68 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Direct and build professional motion design (promo and launch films, kinetic typography, animated explainers, social clips, title sequences) with correct Persian/Farsi and right-to-left typography…

  • Works in 7 steps: Read the brief and fill only real gaps.… → Show directions before building. Motion… → Music first. Lock the track and its… → …
  • The user wants a video
  • SKILL.md covers The director's loop, What separates pro motion from…, Persian non-negotiables and Technique library, plus 2 more sections
  • Runs JavaScript, Python and TypeScript scripts from its folder; calls pip

What it does

Persian Motion Director is an agent skill from atmirrr/persian-motion-director. Direct and build professional motion design (promo and launch films, kinetic typography, animated explainers, social clips, title sequences) with correct Persian/Farsi and right-to-left typography, in Remotion or plain web code. Use this skill whenever the user wants a video, animation, motion graphics, teaser or animated text that contains Persian, Farsi, Arabic-script or RTL text, and whenever they say a motion piece looks "default", "like a slideshow", "AI-made" or "not pro", or that the Persian looks off…

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 73 other files, including scripts, reference files and assets (for example `README.md`, `assets/music/compose_shur_pulse.py` and `assets/remotion/package.json`).

It sits in Media & Creative, covering Motion graphics and Video production. It works with Remotion. The repository describes itself as: A Claude skill for pro motion design with correct Persian (Farsi) typography: no slideshows, no broken letters. 8 techniques, HarfBuzz tooling, Remotion examples. The licence is MIT.

When your agent uses it

  • The user wants a video
  • Motion graphics
  • Animated text that contains Persian
  • Whenever they say a motion piece looks default

Example prompts

  • “default”
  • “like a slideshow”
  • “AI-made”
  • “/persian-motion-director”

Requirements

  • Python 3
  • Node.js

Workflow steps

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

  1. Read the brief and fill only real gaps. Copy (Persian and any Latin), length, aspect ratio, brand colours and fonts, where it will be…
  2. Show directions before building. Motion is subjective and expensive to redo. Pick 6–10 techniques from the library below that fit the…
  3. Music first. Lock the track and its tempo before animating. Build a bar map: which section lives on which bars. If there's no track…
  4. Write the shot list on the bar grid (template in references/workflow.md). Every section change lands on a downbeat; every cut on a beat or…
  5. Style frames. Render 4–6 stills (assets/remotion/render-stills.mjs) and get a yes before animating everything.
  6. Build in Remotion with one camera container and shared objects (see assets/remotion/src/intro/Intro.tsx for a complete worked example).
  7. Check, then render: run scripts/lint_persian.py on all copy, review stills at full size for clipped dots and broken joins, scrub every cut…

What it can do on your machine

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

    Ships 1 file in scripts/ (JavaScript, Python and TypeScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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

Persian Motion Director loads about 2.3k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 223 tokens; SKILL.md has 1,262 words of instructions outside code blocks.

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

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: warnings

The automated check found patterns that need a careful read before installing.

  • WarningContains zero-width charactersSKILL.md:45
    ٠–٩; the half-space (ZWNJ, U+200C) in می⟨U+200C⟩, ‑ها, ‑تر/‑ترین; punctuation ، ؛ ؟ « ». `scripts/lint_persian.py` catches thes

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); the scripts in this folder are not scanned.

SKILL.md

The full file from atmirrr/persian-motion-director at commit 5499640, republished under its MIT licence (© atmirrr). 1,262 words, ~2,330 tokens.

Download SKILL.mdSave it as .claude/skills/persian-motion-director/SKILL.md (or your agent's skills folder). This skill also uses 67 other files; get the full folder from GitHub.
name
persian-motion-director
description
Direct and build professional motion design (promo and launch films, kinetic typography, animated explainers, social clips, title sequences) with correct Persian/Farsi and right-to-left typography, in Remotion or plain web code. Use this skill whenever the user wants a video, animation, motion graphics, teaser or animated text that contains Persian, Farsi, Arabic-script or RTL text, and whenever they say a motion piece looks "default", "like a slideshow", "AI-made" or "not pro", or that the Persian looks off, broken or disconnected, even if they never say "motion design". It brings the anti-slideshow method (one camera, objects that carry across scenes, music-first beat-locked edits), eight ready techniques with live sketches, HarfBuzz tooling for per-letter and per-dot Persian animation, kashida stretching, and a Persian correctness checklist and linter.

Persian Motion Director

You are directing, not just animating. Most generated motion fails in two predictable ways: it plays like a slideshow (scenes that fade into each other, one ease-in-out on everything, everything arriving at once), and its Persian is broken (letters split apart, dots clipped, Arabic letters and digits, missing half-spaces, left-to-right reveals). This skill fixes both. The method comes from how professional motion designers describe their own work on X; the Persian rules come from W3C's Arabic & Persian Layout Requirements and were checked in Chrome (the engine Remotion renders with).

The director's loop

Work in this order. Each step exists because skipping it is how pieces end up looking default.

  1. Read the brief and fill only real gaps. Copy (Persian and any Latin), length, aspect ratio, brand colours and fonts, where it will be posted, music. If a brand exists, use its palette and fonts instead of inventing one.
  2. Show directions before building. Motion is subjective and expensive to redo. Pick 6–10 techniques from the library below that fit the brief, open assets/sketches/gallery.html (or render the clips) and let the user choose. Rework after a full build costs ten times more than a pick list.
  3. Music first. Lock the track and its tempo before animating. Build a bar map: which section lives on which bars. If there's no track, compose one (assets/music/compose_shur_pulse.py is a working example that writes beats.json) or ask for one. At 120 BPM one beat is 0.5 s and one bar 2 s; at 60 fps a beat is 30 frames.
  4. Write the shot list on the bar grid (template in references/workflow.md). Every section change lands on a downbeat; every cut on a beat or 2 frames before it.
  5. Style frames. Render 4–6 stills (assets/remotion/render-stills.mjs) and get a yes before animating everything.
  6. Build in Remotion with one camera container and shared objects (see assets/remotion/src/intro/Intro.tsx for a complete worked example).
  7. Check, then render: run scripts/lint_persian.py on all copy, review stills at full size for clipped dots and broken joins, scrub every cut against the beat, and make loops exact (clip length = a whole number of loops).

What separates pro motion from a slideshow

Slideshow habitWhat to do instead
Scenes chained with fade transitionsOne camera travels between scenes, or one object carries into the next scene. Never fade() scene to scene.
The same ease-in-out on everythingEach move gets its own curve. Entrances: bezier(.16,1,.3,1) over ~20 frames. Exits: bezier(.7,0,.84,0) over ~8 frames, travelling only ~70% as far.
Everything arrives together, evenly spacedOne lead element, the rest 2–4 frames behind, spaced on a curve rather than evenly.
Remotion's default bouncy spring() (overshoots ~16%)Under 2% overshoot on UI, none on text: stiffness 100 / damping 16 gives ~1.5%.
Music laid on at the endMusic first; cuts on the beat; sound attacks placed on the visual hits.
Centered text on a gradient, logo at the endShow the real product doing a real task in the first 10 seconds.
Freezes, or motion that never pausesHold long enough to read; only the camera breathes (zoom 1.00 → 1.04 per scene).
Grain, halftone or ASCII as a finishTexture only with a physical reason (paper, print, light). These finishes are now the AI default.

More numbers and the sources behind them: references/anti-slideshow.md.

Persian non-negotiables

Read references/persian-typography.md before writing any Persian into a frame. The short version:

  1. Never put Persian letters in their own boxes. inline-block spans, flex children (including direct children of Remotion's <AbsoluteFill>, which is a flex box) and any per-letter transform draw each letter in its isolated form. Animate whole words or lines. When you truly need per-letter or per-dot motion, use shaped outlines (scripts/shape_persian.py) or zero-width-joiner splitting (scripts/split_fa.js).
  2. Fade words, not letters. Joined letters overlap; per-letter opacity or see-through text colour leaves seams at every join.
  3. Masks need slack. Persian reaches far above and below Latin: pad clip masks by about 0.5em top and bottom, use line-height ≥ 1.6 (≥ 2.4 for Nastaliq), or the dots and the top of گ get cut.
  4. Direction. dir="rtl" lang="fa" on every Persian block; wrap Latin names and numbers in <bdi> (or FSI/PDI) or the line scrambles. Reveals and staggers start on the right, camera progress travels left, "next" arrows point left. Play buttons, clocks and numbers are never mirrored.
  5. Characters. Persian ی (U+06CC) and ک (U+06A9), never Arabic ي/ك; Persian digits ۰–۹ (U+06F0–06F9), never Arabic-Indic ٠–٩; the half-space (ZWNJ, U+200C) in می, ‑ها, ‑تر/‑ترین; punctuation ، ؛ ؟ « ». scripts/lint_persian.py catches these.
  6. No letter-spacing. Chrome ignores it inside Persian words (since version 137) and other tools break the joins. Stretch with kashida instead, only after a letter that joins forward, at most one per word.
  7. Load the font, every time. If the Persian font (or its Arabic-script subset) isn't loaded, Chrome silently falls back to a system font. In Remotion use FontFace + delayRender (see assets/remotion/src/fonts.ts).
  8. Copy. Write natural Persian in one register; no word-for-word English idioms. A native reader signs off on every line before render (references/persian-copy.md).
Show full SKILL.md (424 more words)Show less

Technique library

Live code for each is in assets/sketches/sketches.js (plain JS, a pure function of time) and runs both in a browser page and in Remotion through SketchPlayer. Details, numbers and the X posts each comes from are in references/techniques/.

#TechniqueUse it forSketch id
01One camera, no cutsThe spine of a film: scenes on one strip, whip pans with motion blur and parallaxoner
02One shape carries the storyTransitions: a full stop grows into a chat bubble, then into the next full stopmatch
03The real UI, directedProduct beats: real interface in 3D, cursor on arcs, focus pullsui
04Cut on the beatFeature runs and kinetic type: hard cuts on every beat, punch-ins, inverted framesbeat
05On twos, with line boilA hand-drawn layer over clean UI: drawings hold 2 frames, lines wobble 12×/sboil
06Paper cut-out lettersWarm title cards: each joined letter group is a rigid paper piececutout
07Dots lastWordmarks and reveals: letter bodies first, then the dots drop innuqta
08Kashida, not letter-spacingEmphasis on a held note: stretch the joining stroke, measured in calligraphic dotskashida

Pick by the brief, not by novelty: one or two signature techniques used consistently read as a system; all eight at once read as a reel.

Tools in this skill

  • scripts/shape_persian.py — shapes Persian with HarfBuzz and exports SVG outlines split into letter bodies, dots and connected letter groups (pip install uharfbuzz fonttools). This is what makes per-letter, per-dot and kashida animation possible without breaking the script.
  • scripts/split_fa.js — splits a Persian word into letters that keep their joined forms (zero-width joiners), for when outlines are overkill.
  • scripts/lint_persian.py — checks copy (Arabic letters and digits, missing half-spaces, English punctuation, misplaced kashida) and code (letter-spacing, per-letter boxes, missing dir).
  • assets/sketches/ — the motion engine (engine.js), the eight sketches, shaped glyph data, styles and gallery.html (serve the folder with any static server).
  • assets/remotion/ — SketchPlayer (drives a sketch from the frame number), one clip composition per technique, the full intro film as a worked example, and scripts to render clips and stills.
  • assets/music/compose_shur_pulse.py — an original 120 BPM track in Dastgah Shur written in code, with a beat map; shows how to make the edit lock to the music.

When the user only wants a quick piece

Still keep the two non-negotiables that cost nothing: no per-letter boxes for Persian, and no scene-to-scene fades. Use one technique well, set the timing on a beat grid, and render stills to check the Persian before the full render.

© atmirrr, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. 1 hidden character (zero-width or bidirectional) removed. Raw file

Files

SKILL.md and 67 other files (scripts, references, assets) in the repository root of atmirrr/persian-motion-director.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • assets/music/compose_shur_pulse.py
  • assets/remotion/package.json
  • assets/remotion/public/fonts/OFL.txt
  • assets/remotion/public/fonts/Vazirmatn-VF.woff2
  • assets/remotion/public/music/beats.json
  • assets/remotion/public/music/shur-pulse.mp3
  • assets/remotion/public/music/whooshes.mp3
  • assets/remotion/remotion.config.ts
  • assets/remotion/render-clips.mjs
  • assets/remotion/render-stills.mjs
  • assets/remotion/src
  • … and 53 more

Open the folder on GitHubat commit 5499640

Compare with similar skills

Persian Motion Director 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.

Persian Motion Director compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Persian Motion Director this skillatmirrr/persian-motion-director134—~2.3kAutomated safety check: WarnMIT
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.5k6 repos~3.2kAutomated safety check: NotesApache-2.0
Video ShotcraftVincentwei1021/video-shotcraft11k—~2.6kAutomated safety check: PassApache-2.0
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0
Create Remotion GeistMarve10s/Better-Fullstack756—~1.4kAutomated safety check: PassMIT
Product Film Builder (Remotion)Rieranthony/product-film-skill409—~1.4kAutomated safety check: PassMIT

Similar skills

  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.5k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • Video Shotcraft

    Vincentwei1021/video-shotcraft

    Makes cinematic product videos with Remotion from shot recipe cards, a ready template, real page screenshots, camera moves and sound design, or builds a single animated shot.

    11k GitHub stars~2.6k tokensUpdated 6 days ago
    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
  • Create Remotion Geist

    Marve10s/Better-Fullstack

    Create Remotion videos using the Geist design system aesthetic.

    756 GitHub stars~1.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Product Film Builder (Remotion)

    Rieranthony/product-film-skill

    Builds a showreel-grade product film in Remotion using the product's own design tokens, components and voice, from a guided interview through a verified final render.

    409 GitHub stars~1.4k tokensUpdated 15 days ago
    Media & CreativeAuto-check passed
  • Builds marketing and explainer videos in Remotion from rendered scenes, with one real product capture as proof, and cuts them for each platform's formats.

    495 GitHub stars~2.9k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

Works with

Questions about Persian Motion Director

What does Persian Motion Director do?

Direct and build professional motion design (promo and launch films, kinetic typography, animated explainers, social clips, title sequences) with correct Persian/Farsi and right-to-left typography…. Persian Motion Director is an agent skill from atmirrr/persian-motion-director. Direct and build professional motion design (promo and launch films, kinetic typography, animated explainers, social clips, title sequences) with correct Persian/Farsi and right-to-left typography, in Remotion or plain web code.

When should I use Persian Motion Director?

Persian Motion Director fits situations like: the user wants a video; motion graphics; animated text that contains Persian; whenever they say a motion piece looks default.

How do I install Persian Motion Director in Claude Code?

Run `npx skills add atmirrr/persian-motion-director --skill persian-motion-director -a claude-code`. Or copy the skill folder (the atmirrr/persian-motion-director repository) into .claude/skills/persian-motion-director in your project. Claude Code loads it when a task matches its description.

How do I install Persian Motion Director in Codex?

Run `npx skills add atmirrr/persian-motion-director --skill persian-motion-director -a codex`. Or copy the skill folder (the atmirrr/persian-motion-director repository) into .agents/skills/persian-motion-director in your project. Codex loads it when a task matches its description.

Can I use Persian Motion Director 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 atmirrr/persian-motion-director --skill persian-motion-director -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/persian-motion-director, .gemini/skills/persian-motion-director, .github/skills/persian-motion-director and .opencode/skills/persian-motion-director in your project.

What does Persian Motion Director need to run?

Going by SKILL.md and its folder, Persian Motion Director needs JavaScript, Python and TypeScript for the scripts in its folder and the command-line tools its instructions call (pip). Our summary lists: Python 3; Node.js.

Does Persian Motion Director access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Persian Motion Director safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): contains zero-width characters. Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Persian Motion Director use?

Persian Motion Director is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Persian Motion Director use?

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

What are the alternatives to Persian Motion Director?

Skills that share tags, products or a category with Persian Motion Director: Stitch to Remotion Walkthrough Videos (google-labs-code/stitch-skills, 8.5k stars), Video Shotcraft (Vincentwei1021/video-shotcraft, 11k stars), HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars) and Create Remotion Geist (Marve10s/Better-Fullstack, 756 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Persian Motion Director?

atmirrr (a GitHub user) maintains it in atmirrr/persian-motion-director, which has 134 GitHub stars. The repository was last updated on October 6, 2026.

Source: atmirrr/persian-motion-director on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.