К основному содержанию
скилл CX Codex

ffmpeg-animation-timing-reference — скилл для Claude Code: установка

Скилл ffmpeg-animation-timing-reference для Claude Code разбирает единицы времени в FFmpeg и субтитрах ASS/SSA. Помогает выбрать длительность анимации, перехода или подписи и проверить синхронизацию.

MIT 104 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill ffmpeg-animation-timing-reference -a claude-code
Открыть на GitHub

Что делает ffmpeg-animation-timing-reference

Скилл объясняет, в каких единицах задавать время для фильтров FFmpeg и тегов ASS/SSA. В большинстве фильтров FFmpeg время указывается в секундах, а параметр d у zoompan измеряется кадрами. Теги караоке ASS считают сотые доли секунды, а теги анимации, затухания и перемещения — миллисекунды. Путаница между единицами ASS меняет длительность анимации в десять раз.

Скилл подбирает длительность для подписей, переходов и эффектов, учитывая частоту кадров, читаемость и синхронизацию аудио с видео. Внутри есть справочные материалы по длительности, платформам и синхронизации, читаемости подписей, кривым сглаживания и готовым фрагментам команд. Для значений короче 300 мс он предлагает сверять длительность с границами кадров.

Какие задачи решает

  • определить единицы времени параметра FFmpeg
  • разобраться, почему тайминг тега ASS слишком быстрый
  • подобрать длительность перехода или подписи
  • сверить синхронизацию звука и видео
  • подстроить анимацию под частоту кадров

Примеры запросов агенту

  • Объясни, в каких единицах задаётся zoompan d=60.
  • Сколько должна длиться подпись в ASS и как задать её тегом караоке?
  • Проверь тайминг перехода и синхронизацию аудио с видео при 30fps.

Как установить ffmpeg-animation-timing-reference

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill ffmpeg-animation-timing-reference -a claude-code

2Вручную: положить файлы

~/.claude/skills/ffmpeg-animation-timing-reference/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ffmpeg-animation-timing-reference/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ffmpeg-animation-timing-reference

Как установить ffmpeg-animation-timing-reference в Claude Code?

Выполни npx skills add JosiahSiegel/claude-plugin-marketplace --skill ffmpeg-animation-timing-reference -a claude-code. Файл скилла находится по пути ~/.claude/skills/ffmpeg-animation-timing-reference/SKILL.md.

Что делает ffmpeg-animation-timing-reference?

Скилл помогает разбираться в единицах времени FFmpeg и ASS/SSA, подбирать длительность анимаций и подписей и сверять синхронизацию.

Чем отличаются единицы времени в тегах ASS?

Теги караоке \k, \kf и \ko используют сотые доли секунды. Теги анимации \t, затухания \fad и перемещения \move используют миллисекунды.

Исходный текст

SKILL.md · MIT
---
name: ffmpeg-animation-timing-reference
description: |
  Definitive reference for FFmpeg and ASS/SSA animation timing units, optimal durations, and best practices.
  PROACTIVELY activate for: (1) Animation timing questions, (2) ASS subtitle timing, (3) Karaoke timing tags, (4) Caption duration calculation, (5) Transition duration selection, (6) Fade/zoom timing, (7) Frame rate considerations, (8) Platform-specific timing (TikTok/Shorts/Reels), (9) Readability formulas, (10) Audio-video sync tolerances.
  Provides: Complete time unit reference tables, optimal duration guidelines, psychology-based timing recommendations, caption readability formulas, and platform-specific timing profiles.
---

## CRITICAL GUIDELINES

### Windows File Path Requirements

**MANDATORY: Always Use Backslashes on Windows for File Paths**

When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).

### Documentation Guidelines

**NEVER create new documentation files unless explicitly requested by the user.**

---

# FFmpeg Animation Timing Reference

This skill is the authoritative answer to "what unit is this timing value in?" and "how long should this animation be?" for FFmpeg filters and ASS/SSA subtitles. Use it whenever animation, transition, caption, or sync timing is in play.

## Quick Reference Card

| Context | Unit | Example |
|---------|------|---------|
| FFmpeg filters (fade, xfade, drawtext) | **Seconds** | `duration=1.5` |
| FFmpeg `zoompan` `d=` parameter | **Frames** | `d=150` (150 frames) |
| FFmpeg time variable `t` | **Seconds** | `enable='gte(t,2)'` |
| ASS karaoke tags (`\k`, `\kf`, `\ko`) | **Centiseconds** | `{\k100}` = 1 second |
| ASS animation tags (`\t`, `\fad`, `\move`) | **Milliseconds** | `\t(0,500,...)` = 0.5s |
| ASS dialogue timestamps | **H:MM:SS.CC** | `0:00:05.50` |

---

## CRITICAL: ASS Has TWO Different Time Units!

**This is the most common source of confusion in subtitle animations.** Karaoke tags use centiseconds; everything else (animation, fade, move) uses milliseconds. Mixing them up causes animations to run 10x too fast or 10x too slow.

### ASS/SSA Time Unit Disambiguation

| Tag Type | Unit | Conversion | Example |
|----------|------|------------|---------|
| **Karaoke tags** (`\k`, `\kf`, `\ko`, `\K`) | **Centiseconds** (1/100s) | x 100 | `{\k50}` = 0.5 seconds |
| **Animation tags** (`\t`) | **Milliseconds** (1/1000s) | x 1000 | `\t(0,200,...)` = 0.2 seconds |
| **Fade tags** (`\fad`) | **Milliseconds** | x 1000 | `\fad(300,0)` = 0.3s fade in |
| **Move tags** (`\move`) | **Milliseconds** | x 1000 | `\move(x1,y1,x2,y2,0,500)` = 0.5s |
| **Dialogue timestamps** | **H:MM:SS.CC** | Centiseconds | `0:00:01.50` = 1.5 seconds |

### Same Duration, Different Units

```ass
; Both animations last 0.5 seconds but use DIFFERENT UNITS:

; Karaoke: 50 CENTISECONDS = 0.5 seconds
{\k50}Word

; Animation: 500 MILLISECONDS = 0.5 seconds
{\t(0,500,\fscx120)}Word
```

For full karaoke, fade, and move examples plus centisecond/millisecond conversion tables, see `references/copy-paste-patterns.md`.

---

## FFmpeg Time Units (Cheat Sheet)

Most FFmpeg filters take seconds (floating point). The big exception is `zoompan d=`, which is in **frames**.

| Filter / Context | Parameter | Unit |
|------------------|-----------|------|
| `fade` / `afade` | `d`, `st` | Seconds |
| `xfade` / `acrossfade` | `duration`, `offset` | Seconds |
| `drawtext` | `t` variable, `enable` | Seconds |
| `zoompan` | `d` | **Frames** |
| `zoompan` | `t` variable inside `z=` | Seconds |
| `trim` | `start`, `end` | Seconds |
| `fps` | `fps` | Frames/second |

### Zoompan Duration: Frames, Not Seconds

```bash
# d= is FRAMES. For a 2-second zoom:
# 30fps: d=60   (60 frames / 30fps)
# 60fps: d=120  (120 frames / 60fps)
# Formula: frames = seconds * fps
ffmpeg -i input.mp4 -vf "zoompan=z='1.2':d=60:s=1080x1920" output.mp4
```

For viral-style hooks always use `d=1` (per-frame processing) and gate the effect with a time conditional like `if(lt(t,0.5),...)`. Setting `d=60` would freeze the rest of the video. Full hook formulas and platform-specific zoom parameters are in `references/optimal-durations.md`.

---

## Core Workflow

1. **Identify the context** (FFmpeg filter vs ASS karaoke vs ASS animation vs dialogue timestamp) and read the Quick Reference Card to confirm the unit.
2. **Pick a target duration** based on perception (`references/optimal-durations.md`) and platform pacing (`references/platform-and-sync.md`).
3. **Snap to frame boundaries** if the value is short (<300ms) using the frame-safe table in `references/platform-and-sync.md`.
4. **Choose an easing curve** when the motion needs polish (`references/easing-and-springs.md`).
5. **Validate against perception thresholds and sync tolerances** so animations don't fall under the flicker threshold or break lip sync.
6. **Copy the matching pattern** from `references/copy-paste-patterns.md` and adapt parameters.

## Activation Guidance

Pull the right reference based on the question:

| Question shape | Load |
|----------------|------|
| "How long should this caption / transition / hook be?" | `references/optimal-durations.md` |
| "Why does my caption feel too fast / fail WCAG?" | `references/caption-readability.md` |
| "Does this work for TikTok / Shorts / Reels / broadcast?" | `references/platform-and-sync.md` |
| "Is my lip sync / beat sync within tolerance?" | `references/platform-and-sync.md` |
| "Will this duration look smooth at 30fps / 60fps?" | `references/platform-and-sync.md` |
| "Which easing curve / spring should I use?" | `references/easing-and-springs.md` |
| "Give me a ready-to-paste timing snippet." | `references/copy-paste-patterns.md` |

## Quick Duration Cheat Sheet

| Duration | Use For |
|----------|---------|
| 50-100ms | Glitch, flash |
| 100-200ms | Quick UI feedback |
| 200-300ms | Standard animation |
| 300-500ms | Smooth transition |
| 500-800ms | Noticeable movement |
| 800-1500ms | Dramatic effect |
| 1.5-3s | Caption display |
| 3-5s | Long text reading |

Hard floors: WCAG minimum caption duration is 1.5s. Minimum perceivable animation is ~67ms at 30fps, ~33ms at 60fps. Lip sync tolerance is +/-80ms (target +/-40ms).

---

## Reference Map

In-skill references (load on demand):

- `references/optimal-durations.md` - Human perception thresholds, recommended durations for text animations, video transitions, hook effects, karaoke; viral-video 1.3s attention threshold and platform-specific zoom parameters/hook formulas.
- `references/caption-readability.md` - Reading speed standards (WPM), caption duration formula, Python implementation, WCAG 2.2 accessibility requirements.
- `references/platform-and-sync.md` - TikTok / YouTube Shorts / Instagram Reels / Broadcast timing profiles, audio-video sync tolerances (lip sync, music, karaoke, SFX), frame rate precision and frame-safe duration table.
- `references/easing-and-springs.md` - Material Design timing, FFmpeg easing expressions, complete easing formulas (linear, quadratic, cubic, exponential, sine, circular, elastic, bounce, back), spring physics (mass-spring-damper), oscillation/wave/Lissajous formulas, pseudo-random noise, jitter/shake, fade/scale/position/rotation cookbook, biological rhythms, sources.
- `references/copy-paste-patterns.md` - Ready-to-paste FFmpeg and ASS timing snippets, frame rate conversion table, zoompan duration calculation.

## Related Skills

- `ffmpeg-karaoke-animated-text` - Karaoke subtitle creation
- `viral-video-animated-captions` - CapCut-style animations
- `ffmpeg-transitions-effects` - Video transitions
- `viral-video-hook-templates` - Hook timing patterns
- `ffmpeg-captions-subtitles` - Subtitle fundamentals

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Дизайн» →
Animation Principles - Universal Reference dylantarre Скилл Animation Principles - Universal Reference для Claude Code разбирает 12 принципов анимации Диснея и помогает подбирать глубину ответа к уровню знаний собеседника. CX Codex +1 577установок timing-mastery dylantarre Скилл timing-mastery задаёт ритм и длительность движений в анимации через расчёт кадров. Помогает настроить темп жестов, пауз и акцентов. CX Codex +1 663установок timing coleam00 Правило timing для Claude Code объясняет интерполяцию, easing и spring-анимации в Remotion. Настраивает движение элементов по кадрам. CX Codex +1 ★ 849звёзд репо layer-reference-sets layerai Скилл layer-reference-sets для Claude Code помогает обучать стили Layer на своих изображениях и применять их в генерациях. Он подключается к задачам с наборами референсов, LoRA и нестабильным результатом. CX Codex +1 4 900установок reference-to-motion charlie947 Скилл reference-to-motion для Claude Code разбирает видео и референсы стиля, чтобы собрать промпт для Claude Motion с таймингами сцен под бренд. Создаёт промпты для моушн-роликов по образцу. CX Codex +1 3 000установок pptx-reference-deck-analysis kimtth Скилл pptx-reference-deck-analysis для Claude Code, Codex и Cursor, который разбирает чужую презентацию как образец: тема, шрифты, ритм раскладки, структура. Исходный файл не меняется. CX Codex +1 2 500установок

Из того же набора96

Весь набор →
ffmpeg-opencv-integration Скилл ffmpeg-opencv-integration для Claude Code и Codex помогает связать FFmpeg и OpenCV в Python-скриптах. Защищает от путаницы в RGB/BGR, сбоев с пайпами и потери звука при обработке кадров. CX Codex +1 107установок unity-ui-development Скилл unity-ui-development помогает проектировать интерфейсы в Unity на UGUI и UI Toolkit. Подсказывает разметку UXML, стили USS, привязку данных и настройку RectTransform. CX Codex +1 107установок viral-video-platform-algorithms Скилл viral-video-platform-algorithms для Claude Code разбирает алгоритмы TikTok, YouTube, Instagram и Facebook. Активируется для стратегии продвижения, охватов, хештегов и времени публикаций. CX Codex +1 106установок azure-ml-foundry-workspace Скилл azure-ml-foundry-workspace для Claude Code настраивает Azure Machine Learning и Azure AI Foundry: рабочие пространства, сети, вычисления и развёртывание моделей. Разбирает конфигурацию и журналы. CX Codex +1 105установок unity-networking Скилл unity-networking для Claude Code помогает разрабатывать сетевую многопользовательскую игру в Unity. Активируется для настройки NGO, Mirror, Photon или Fish-Net, а также RPC и лобби. CX Codex +1 103установок unity-performance Скилл unity-performance разбирает просадки FPS и фризы в Unity: что открыть в Profiler, как убрать лишние draw call и откуда берутся рывки на сборке мусора. CX Codex +1 103установок unity-editor-tooling Скилл unity-editor-tooling для Claude Code помогает писать инструменты редактора Unity и автоматизировать сборки. Активируется при работе с инспекторами, окнами редактора, импортёрами и CI/CD. CX Codex +1 102установок dax-mastery Скилл dax-mastery для Claude Code помогает писать DAX для семантических моделей Power BI. Активируется при работе с мерами, вычисляемыми столбцами, контекстом фильтров и временными расчётами. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой