CDAF — скилл
Скилл и формат .cdaf: текстовое описание видео рядом с файлом, чтобы агент читал его, а не пересматривал ролик заново.
- 226 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команда `cdaf generate` загружает видео в Gemini Files API по вашему ключу, и содержимое роликов покидает машину.
- Описание выводит модель, и в нем возможны пропуски или ошибки, на которые агент опирается вместо просмотра самого видео.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/cdafОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команда `cdaf generate` загружает видео в Gemini Files API по вашему ключу, и содержимое роликов покидает машину.
- Описание выводит модель, и в нем возможны пропуски или ошибки, на которые агент опирается вместо просмотра самого видео.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CDAF — открытый формат: рядом с видео лежит файл с тем же именем и расширением `.cdaf`. В нем текстовое описание с метками времени: краткое содержание, сегменты, расшифровка речи, текст на экране и теги. В заголовке записаны SHA-256 и размер видео, поэтому при изменении ролика описание считается устаревшим. Скилл, который ставит `npx cdaf-skill`, учит агента порядку действий: перед анализом видео найти файл `.cdaf`, сверить хэш, прочитать описание вместо просмотра, а при устаревании пересоздать. Команда `cdaf generate` описывает папку с видео через Gemini по вашему ключу, а `cdaf status`, `cdaf read` и `cdaf validate` работают без ключа. По замеру автора на Gemini 2.5 Flash ответы по описанию совпали с анализом самого видео (20 из 20 против 19 из 20), промптов ушло в 10,1 раза меньше.
Для кого. Разработчикам видеомонтажа на Remotion или HyperFrames и всем, чьи агенты многократно разбирают одни и те же ролики в Claude Code.
Подходит, если
- Агент монтирует ролик из 40 исходных клипов, и каждый раз пересматривать их слишком дорого.
- Нужны планы по запросу вроде «закат у моря без людей», и выбор делается поиском grep по описаниям.
- Тайминги сегментов идут прямо в нарезку для Remotion.
- Ролик перемонтировали, и описание надо отловить как устаревшее по хэшу.
Не подходит, если
- Видео анализируется один раз и не используется повторно: создание описания не окупится.
- Отправлять видео в сторонний сервис нельзя, а генерация описаний идет через Gemini.
- Нужен точный покадровый анализ движения, а описание дает только текстовый пересказ.
Пример запроса к агенту
Прежде чем смотреть ролики из папки footage, проверь файлы .cdaf, а для устаревших создай новые описания.Ограничения
Генерация описаний требует Python 3.10 или новее, ключ Gemini API в переменной `GEMINI_API_KEY` и установки CLI из репозитория: пакета в PyPI пока нет. Ролики при этом уходят в Gemini Files API. Чтение, проверка и статус обходятся без ключа и зависимостей. Для длинных роликов нужен ffprobe, чтобы точно записать длительность. Заявленное сокращение расходов получено на тестовых роликах самого автора, на ваших материалах оно будет иным.
Как отключить. Удалите скилл папкой `~/.claude/skills/cdaf` и пакет командой `pip uninstall cdaf`. Файлы `.cdaf` рядом с видео безвредны, их можно оставить или удалить.
Частые вопросы
Как установить скилл CDAF?
Выполните `npx cdaf-skill`. Скилл ляжет в `~/.claude/skills/cdaf`. Флаг `--project` ставит его только в текущий проект.
Как создать описания для папки с видео?
Поставьте CLI из репозитория, задайте `GEMINI_API_KEY` и выполните `cdaf generate ./footage`. Свежие описания команда пропускает.
Что значит устаревшее описание?
Хэш или размер в заголовке `.cdaf` не совпали с видео. `cdaf read` в этом случае отказывается выводить текст.
Работает ли формат с другими агентами?
Да. Весь контракт умещается в один абзац системной инструкции, его выводит `npx cdaf-skill --print`.
Нужен ли ключ, чтобы читать готовые описания?
Нет. Команды `read`, `validate` и `status` работают без ключа и без зависимостей.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл /watch: по ссылке или файлу достает кадры и субтитры, а при ключе Gemini передает видео целиком Google, чтобы агент отвечал на вопросы по ролику
Motion Video Skill
motion-video-skill
Видео 1080p с синхронизацией по ударам: HyperFrames и GSAP, озвучка, караоке-субтитры, звуки и музыка. Ключи провайдеров хранятся в конфигурации CLI
CLI и скилл для Claude Code, Codex и Cursor: индекс видео, поиск по словам и тексту кадра, кадры крупно и замер монтажа
Скилл превращает идею, ссылку или скринкаст в готовое видео: аватар HeyGen, b-roll, субтитры и контроль качества
Скиллы монтажа коротких видео
ChatGPT 剪短影音 Skills
Пара скиллов для агента: настройка среды монтажа и сборка вертикального короткого видео по восьми шагам с проверкой
Скиллы для работы с видео в Claude Code и Codex: покадровый разбор ролика на кадры и сборка видео с раскадровкой
Коротко о README
Репозиторий содержит спецификацию формата версии 1.0, ядро и CLI на Python, скилл для Claude Code, воспроизводимый бенчмарк на синтетических роликах и черновик научной статьи. Основа формата — хэш видео в заголовке.