reelbench-skills README

README проекта с github.com/eternityspring/reelbench-skills. Одним файлом markdown: README.md.

reelbench-skills

Claude Code / Codex skills for working with video.

English | 中文 | Telegram @ahao_dev | X @eternityspring

Skills · Install · Example · What it looks like

❤️ Sponsor

Want to appear here?

Click to collapse
Reelbench Studio Reelbench Studio is a paid AI video workspace built by the author of these skills, delivered as source code that runs offline. Local Codex handles understanding, breakdown and orchestration, a self-hosted ComfyUI generates the images and video, and your assets and projects stay on your own machine.
赛博班底 mini program code 赛博班底 is a WeChat mini program built by the author of these skills: reference images for AI short video, covering characters, costumes, expressions and more, filterable by category and tag. Every image comes with a Chinese prompt you can copy in one tap, and you can long-press the full-size image to save it. Scan the code on the left in WeChat to open it.

Skills

skill what it does
video-shots Shot breakdown: turns a finished film into a shot-by-shot table — duration, shot size, category, camera move, frame description, rhythm role. Cuts and durations are measured by ffmpeg; the model only judges what it should; 15 quality gates check every call.
video-sync Composites a video with the shot data alongside it: footage on one side, the current shot's data on the other, switching at every cut with the list scrolling and highlighting itself. Landscape stacks, portrait sits side by side; the layout is one CSS file.
video-scrub Strips metadata: rebuilds the film as a clean file carrying only picture and sound — GPS, device, account IDs and telemetry tracks all left behind. The hard part is the three layers ffprobe cannot see: SEI, the AAC DSE, and compressorname. Byte-for-byte picture by default, verified by 12 byte-level gates.

AI video community

I run a paid group about AI video — workflows, tools, and how this stuff actually gets done.

Interested? Message me on Telegram @ahao_dev and mention github.

Install

git clone https://github.com/eternityspring/reelbench-skills.git
cd reelbench-skills
./scripts/install.sh

This symlinks the skills into ~/.claude/skills/ and/or ~/.codex/skills/ (whichever exists), so git pull takes effect immediately.

./scripts/install.sh --claude      # Claude Code only
./scripts/install.sh --codex       # codex only
./scripts/install.sh video-shots   # one skill only
./scripts/install.sh --uninstall   # remove the symlinks

Requirements: node >= 18 and ffmpeg / ffprobe (macOS: brew install node ffmpeg). No npm dependencies, no API keys — it runs on your current session.

Prefer a copy over a symlink? cp -r skills/video-shots ~/.claude/skills/ — each skill is self-contained.

Example

demo-report/ is the real output of running the skill on demo-video.mp4 (a 202.9-second AI-generated short film, 啥是AI): 53 shots, 3.83 s average shot length, 15.7 cuts per minute, all 15 gates green. demo-report-en/ is the same pipeline run on a 287.4-second English excerpt with --lang en — an entirely English report: 46 shots, 6.25 s average, and one 46.92 s take that scene detection never cut, because it genuinely never cuts.

Shot breakdown report

The report is a single interactive page: an embedded player (playback highlights the current shot, click a shot to jump), a pace strip, a shot list you can search, filter and sort (list or card view, first and last keyframe side by side, click a frame to enlarge), distributions, cast, and the quality gates. No external dependencies — double-click it offline.

the shot list on a narrow screen
demo-report/
├── shots-report.html   ← clone and double-click
├── shots.json          ← the breakdown data for all 53 shots
├── shots.md            ← Markdown shot list
├── track.json          ← frame-difference motion curve (the machine's evidence)
└── frames/             ← first and last keyframe of every shot, 106 files

demo-scrub/ is what video-scrub produces — four pieces of text and no video, because its output looks exactly like the source, which is the whole point. What is worth reading is the reconciliation, above all half.txt: the textbook recipe leaves ffprobe looking spotless while the bitstream still carries x264's encoder-settings SEI in 4 places and the AAC DSE in 8 — no ffprobe command shows either of them.

What video-sync produces is at the bottom of this page — as a video, not a screenshot.

What it looks like

A 287.4-second English excerpt with its 46-shot breakdown, 1280×1296 (the source is 640×360, blown up with --scale 2). The panel switches with every cut; the list scrolls up and the highlight rides along:

If the player does not load, grab the file: demo-sync/demo-en-sync.mp4

reelbench-skills (eternityspring/reelbench-skills)

Ищем в базе…

Что это такое?Набор из трёх навыков для Claude Code и Codex для работы с видео, созданным ИИ: инструмент для покадрового анализа, просмотрщик, который синхронизирует видео с данными, и инструмент для очистки метаданных.
Это отдельные приложения или навыки, которые я подключаю к агенту?Это пакеты навыков, а не отдельные приложения: их устанавливают через символические ссылки в папку навыков Claude Code и/или Codex, а агент запускает их во время сеанса.
Как установить эти навыки?Установщик создаёт символические ссылки на три папки навыков в ~/.claude/skills/ и/или ~/.codex/skills/ (в зависимости от того, какая из них существует), поэтому последующая команда 'git pull' обновит их на месте. Если вы не хотите использовать символические ссылки, каждый навык самодостаточен и его можно скопировать напрямую, например: 'cp -r skills/video-shots ~/.claude/skills/'.
Что нужно установить перед использованием?Node.js 18+ и ffmpeg/ffprobe в PATH (macOS: 'brew install node ffmpeg'). Зависимости npm и ключи API не нужны: всё работает внутри текущего сеанса агента.
Действительно ли очистка метаданных в video-scrub полная?По умолчанию она даёт побайтово идентичную картинку и проходит 12 проверок на уровне байтов. Самые сложные случаи — это три слоя, которые ffprobe даже не видит: демонстрация показывает, что стандартный «чистый» рецепт всё равно оставляет SEI с настройками кодировщика x264 в 4 местах и DSE в AAC в 8 местах, которые не обнаруживает ни одна команда ffprobe.
Покидают ли мой компьютер какие-либо данные видео?Нет. Анализ и очистка выполняются локально через ffmpeg/ffprobe в текущем сеансе. Video-scrub удаляет GPS, данные об устройстве, ID аккаунтов и телеметрию и ничего не загружает.
Что именно выдаёт video-shots для фильма?Таблицу покадрового разбора с длительностью, размером плана, категорией, движением камеры, описанием кадра и ролью в ритме. Монтажные склейки и длительности измеряет ffmpeg, а модель оценивает только качественные поля. Результат проверяется по 15 контрольным проверкам качества.
Как выглядит video-sync при запуске?Он совмещает исходное видео с прокручиваемой панелью данных, которая подсвечивает текущий кадр и переключается на каждой склейке. Для горизонтального видео панель располагается друг над другом с видео, для вертикального — рядом с ним.
Можно ли посмотреть отчёт анализа кадров без настройки сервера?Да. Результат — это одна самодостаточная интерактивная HTML-страница, которую можно открыть двойным кликом и просматривать офлайн. На ней есть список кадров с поиском и сортировкой, полоса темпа, ключевые кадры и проверки качества.
Зачем мне вообще нужен video-scrub?Чтобы удалить личные метаданные (GPS, данные об устройстве, ID аккаунтов, телеметрию) из видеороликов, созданных ИИ, перед тем как ими делиться. При этом картинка и звук остаются побайтово неизменными.
Автор
eternityspring
Размер
101.4 MB
Звёзды
1.2K
Обновлён
КоммитNov 09
Возраст
2 мес
Коммиты · 90 дней