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

oma-video — скилл для Claude Code: что делает и как установить

Создаёт видео через CLI OMA video или обрабатывает готовый клип: извлекает кадры, режет паузы, собирает дубляж.

MIT ★ 1 472 обновлён 2026-11-12

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает oma-video

Скилл работает в двух режимах. Для создания с нуля он берёт бриф и собирает короткое видео, объяснение по README или коду, либо демо-запись экрана — в зависимости от запроса подбираются формат кадра и длительность, а результат складывается в .agents/results/videos/<timestamp>-<shortid>-<mode>/ вместе с script.json, timing.json, render-spec.json и manifest.json с хешами и предупреждениями.

Для работы с уже существующим видео скилл подгружает сторонний kajisho5/ffmpeg-skill, который берёт на себя извлечение кадров, подсчёт объектов в кадре, вырезание пауз и сборку дубляжа. Для звуковых эффектов и проверки звука к видео подключается Leonxlnx/earshot.

Демо-режим требует, чтобы человек сам записал экран и выполнил вход в сервисы — флаг --source web --url даёт только контекст и не запускает рекордер. Без --capture скилл просто выдаёт инструкции по записи и останавливается. Для реального рендера нужен FFmpeg/FFprobe и Python, а OMA_VIDEO_MOCK=1 создаёт только тестовые заглушки без настоящего видео.

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

  • собрать короткое видео или reel по бриф-описанию
  • сделать видео-объяснение по README или коду
  • извлечь кадры из видео и посчитать объекты в них
  • вырезать паузы и собрать дублированную озвучку
  • добавить звуковые эффекты и проверить звук к видео

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

  • Сделай вертикальный reel по этому брифу в режиме shorts
  • Вырежь паузы из demo.mp4 и собери дублированную версию
  • Проверь, совпадает ли звук в video.mp4 с картинкой, и добавь эффекты

Как установить oma-video

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

Команда ставит плагин oma целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-video -a claude-code

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

~/.claude/skills/oma-video/SKILL.md

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

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

Вопросы об oma-video

Как установить oma-video в Claude Code?

Выполните /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent.

Что делает oma-video?

Создаёт видео через CLI OMA video в режимах shorts, explainer и demo, а также анализирует и редактирует уже существующие клипы: извлекает кадры, режет паузы, собирает дубляж.

Чем отличается создание видео от обработки готового клипа?

Создание идёт через собственный конвейер OMA с script.json, timing.json и render-spec.json, а обработка существующего видео делегируется стороннему kajisho5/ffmpeg-skill, который работает со своим форматом project.json и не проходит через лимиты создания.

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

SKILL.md · MIT
---
name: oma-video
description: Create videos through the OMA video CLI, or analyze and edit
  existing clips with media tools. Use for frame extraction, visual analysis,
  silence cuts, dubbing assembly, sound effects, scripts, and composition;
  audio-only work uses oma-voice.
---

# Video Router

## Scheduling

### Goal

Create a playable video, or derive requested frames, analysis, or edits from an
existing clip while retaining its source timeline.

### Intent signature

- Create a short, explainer, or recorded demo.
- Extract frames, count visible objects, remove pauses, or assemble a dubbed clip.
- Add sound effects to a video or check its soundtrack against the picture.

### When to use

Use this skill for a short/reel, README or code explainer, demo walkthrough, or
analysis and editing of an existing video.

| Request | Mode | Default aspect | Required source |
|---|---|---|---|
| Short, reel, social clip | `shorts` | `9:16` | Topic or brief |
| README, code, data explanation | `explainer` | `16:9` | Topic or source path |
| Demo or walkthrough | `demo` | `16:9` | Human recording via `--capture` |

Processing a supplied or already-rendered video conditionally loads the upstream
`kajisho5/ffmpeg-skill` through `resources/existing-media.md`. This is separate
from the OMA creation modes. Sound effects, a sound-designed soundtrack, or
listening checks on a video's audio conditionally load `Leonxlnx/earshot`
through `resources/sound-design.md`.

### When NOT to use

Use `oma-image` for a still image, `oma-slide` for a deck, `oma-voice` for
audio only, and `oma-explanation` for an interactive HTML explainer. Route
transcription, synthesis, and TTS duration fitting to `oma-voice`, and spoken
translation to `oma-translation`; this skill owns their placement in video.
Live streaming is out of scope.

### Expected inputs

A creation brief, or an existing clip plus the requested analysis/edit, selected
streams, timing or sampling requirements, and output path.

### Expected outputs

A generated video and its asset bus, or requested frames/analysis/edited media
with source timestamps and the parameters used to derive them.

### Dependencies

Creation requires the selected OMA providers/compositor. For processing supplied
or rendered video, use the runtime skill catalog first; otherwise load
`kajisho5/ffmpeg-skill` with `bunx skills use` as described in the conditional
resource. Its complete support bundle, Python, FFmpeg/FFprobe and any
operation-specific capabilities are required. Sound effects and audio listening
use the upstream earshot skills plus a resolved earshot runtime with
FFmpeg/FFprobe; never install it without consent. Visual interpretation uses the
host vision tool. Report unavailable capabilities rather than invent results.

## Structural Flow

For supplied or already-rendered video, use the existing-media branch in the
canonical path. The upstream skill owns its scripts, flags, templates,
`project.json` and mechanical editing workflow. OMA retains source-timeline
evidence and the visual, speech and editorial decisions described there. Its
project format is separate from the OMA creation asset bus below.
For creation, inputs are a brief plus optional mode, aspect, locale, captions,
visual, voice, music, duration, compositor, capture path, and seed. Outputs live in
`.agents/results/videos/<timestamp>-<shortid>-<mode>/`:

- `script.json`, `timing.json`, and `render-spec.json` form the deterministic
  asset bus.
- Captions and acquired audio/visual assets are recorded in `manifest.json`
  with hashes, providers, cost, warnings, and exit code.
- A successful real render contains `<mode>-<slug>.mp4`, an encoded video
  stream, and a positive ffprobe duration.

`OMA_VIDEO_MOCK=1` is a test harness only. It can create deterministic text
placeholders with an `.mp4` name; those files are never a user deliverable. A
missing HyperFrames/MPT toolchain, an un-authored composition, a render error, or
an invalid video fails with diagnostics and leaves the script/render spec for
recovery.

### Decide and confirm

For creation, infer mode when clear: short/reel -> `shorts`;
README/code/data/explain -> `explainer`; demo/walkthrough/capture -> `demo`.
For a one-line creation request, state
the inferred mode, aspect, duration, visual strategy, captions, locale, and
voice/music before invoking. Do not make the user complete a questionnaire
when those defaults are clear.

Ask only when it changes the result: an ambiguous mode/source, a required demo
recording, or a cost confirmation. Respect an explicit mode, aspect, duration,
captions, or voice verbatim.

For a demo, a human records the screen and controls login. `--source web --url`
provides context only; it never automates login or starts a recorder. Without
`--capture`, return guided capture instructions and stop.

## Logical Operations

### Guardrails

1. Keep output and capture paths inside `$PWD` unless external output is
   explicitly allowed. Validate capture formats and copy external assets into
   the run directory. Mask URL query/hash tokens in logs and manifests.
2. Provider configuration is key-optional: use the configured chain. Paid
   providers require their environment key and the cost guardrail. Local
   fallbacks may replace voice, visuals, captions, or music; record coverage in
   warnings. A compositor failure is never a fallback video.
3. Before a paid provider action or rerun, compare the planning estimate with
   `cost.guardrail_usd` or `--max-usd` and reuse existing spend authorization.
   In an active OMA video workflow, record the actual paid, limited, fallback, or
   declined choice before executing it (execution protocol Step 2). Pass `--yes`
   or `OMA_VIDEO_YES=1` only for an already authorized paid action; the event does
   not grant permission.
4. For creation, respect `limits.max_duration_sec` (180) and
   `limits.max_scenes` (40). Cancel subprocess work on SIGINT/SIGTERM.
5. Keep run directories. Never auto-prune a user’s video artifacts.
   A demo capture is inspected for personal information and masked before
   render (`resources/hyperframes-authoring/demo.md`); an unchecked capture is
   not rendered.
6. Creation via `oma video generate --dry-run` writes only planning artifacts
   and does no provider render. It does not prove an MP4 exists. For delegated
   media work, follow the loaded upstream operation's dry-run contract.

### Canonical command path

1. Supplied or already-rendered video: load `resources/existing-media.md`.
   Resolve the upstream skill, follow its supported operation, and retain OMA
   timeline and interpretation evidence. These operations do not pass through
   `oma video generate` or the creation-only limits above.
2. New video: use the commands below and the creation pipeline. Keep existing
   `shorts`, `explainer`, and `demo` behavior.
3. Sound effects or soundtrack listening on either path: load
   `resources/sound-design.md`. earshot supplies the sounds and the listening
   evidence; OMA keeps cue times, placement in the composition, and delivery.
4. For an existing-media or sound-design route, record the selected upstream
   skill and operation with subject `video.route-selection` per
   `references/_shared/runtime/route-selection.md`. Creation runs keep recording
   `video.mode-selection` through the video workflow instead.

```bash
# Plan or create the asset bus. Supply --script whenever an agent authored it.
oma video generate "Jeju coffee" --mode shorts --aspect 9:16 \
  --captions tiktok --script ./script.json --output json

# Deterministic planning only; no real render or provider work.
oma video generate "explain this project" --mode explainer --seed 42 --dry-run

# Human-recorded demo input.
oma video generate "feature walkthrough" --mode demo --capture <absolute-path>.mp4

# Scaffold the per-run HyperFrames project, author index.html as instructed,
# then render and validate the encoded output.
oma video compose <runDir> --output json
oma video render <runDir> --output json

# Diagnose required toolchains without changing a run.
oma video doctor
oma video provider list
```

`oma video generate --output json` returns
`{exitCode, runDir, manifestPath, scriptPath, renderSpecPath, warnings, error}`.
Read video and asset paths from the manifest; the JSON envelope has no
`outputs` field.

### Failure and recovery

- Missing HyperFrames composition: `oma video compose <runDir>` prepares the
project and authoring contract. Author `<runDir>/hyperframes/index.html` using
the generated `AUTHORING.md`, then invoke `oma video render <runDir>`. The
command lints, renders, and ffprobes the output. Fix a reported composition
or toolchain failure and re-run; return a failure report when it cannot render.

- Missing MPT toolchain: `--compositor mpt` requires the installed checkout, its virtual environment,
and ffmpeg. Use `oma video doctor --install-mpt` when setup is authorized and
available. MPT setup failures, driver failures, and non-video output fail with
the diagnostic; they do not write a placeholder MP4.

For creation, success means all asset schemas and manifest hashes validate and a
real MP4 passes video-stream and duration validation. A partial success may use a
key-free visual, timing, caption, or music fallback, but it still requires that
real video validation.

## References

### Conditional resources

Load only what the task needs:

- `resources/execution-protocol.md` for the creation pipeline, failure
  mapping, and JSON reporting rules.
- `resources/existing-media.md` when processing supplied or rendered video:
  upstream skill loading, source-timeline evidence and visual/speech decisions.
- `resources/sound-design.md` when a video needs sound effects, foley, ambience
  or soundtrack review: earshot routing, cue placement and listening evidence.
- `resources/vendor-matrix.md` before changing providers, keys, cost, or
  fallback order.
- `resources/script-schema.md` when authoring or validating `--script` input.
- `resources/prompt-tips.md` when turning a brief into scene prompts.
- `resources/motion-principles.md` when authoring `script.json` or the
  composition: scene cast, motion, text, narration sync and diagram rules.
- `resources/hyperframes-authoring/README.md` and the selected mode guide before
  writing `index.html`.
- `resources/checklist.md` before handing a newly generated video to a user.

### Verification

For CLI/runtime changes, add a regression test for the affected success and
failure paths. At minimum run the focused Vitest files, for example:

```bash
cd cli
bunx vitest run commands/video/providers/compositor.test.ts \
  commands/video/orchestrator.test.ts
bunx biome check commands/video/providers/compositor.ts \
  commands/video/providers/compositor.test.ts
```

Do not run a live render merely to test documentation or a mock-only branch.

© First Fluke · MIT · first-fluke/oh-my-agent

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

Все скиллы по теме «ИИ и ML» →
video-to-gif zc277584121 Скилл video-to-gif делает из видео несколько GIF с разными настройками и складывает их в одну папку, чтобы вы глазами выбрали подходящий. CX Codex +1 3 900установок convert-video Samarth Gupta Скилл convert-video обрабатывает видео через FFmpeg по текстовым запросам: меняет контейнеры, обрезает хронометраж, ускоряет дорожки и масштабирует кадр. CX Codex +1 ★ 276звёзд репо higgsfield-video-explainer higgsfield-ai Скилл higgsfield-video-explainer для Claude Code перенаправляет старый сценарий создания видео-объяснения в иллюстрированный процесс Higgsfield. Он включается при явном вызове или продолжении прежнего рабочего процесса. CX Codex +1 162 100установок broll Melvynx Скилл broll для Claude Code, создающий доступную для поиска библиотеку видеофутажа. Индексирует клипы, выполняет их автоматическую разметку и поиск по запросу. CX Codex +1 1 700установок vidmuse SandAI-org Скилл для работы с проектами VidMuse: вытаскивает данные аккаунта, доступные модели, загруженные файлы, стили и голоса, параметры генерации, треды и память. CX Codex +1 771установок pixverse-ai-image-and-video-generator PixVerseAI Скилл pixverse-ai-image-and-video-generator для Claude Code создаёт и редактирует изображения, видео, речь и музыку через PixVerse CLI. Запускает шаблоны эффектов, MiniApps и Canvas-сценарии. CX Codex +1 1 100установок

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

Весь набор →
oma-coordination Скилл oma-coordination помогает вручную координировать работу нескольких специализированных агентов. Он раскладывает задачу по этапам, отслеживает договорённости между командами и доводит работу до QA-проверки. CX Codex +1 ★ 1 472звёзд репо oma-hwp Скилл oma-hwp превращает корейские документы HWP, HWPX и HWPML в Markdown через kordoc. Извлекает текст, таблицы, списки, изображения и сноски. CX Codex +1 ★ 1 472звёзд репо oma-pdf Скилл oma-pdf конвертирует PDF-документы в Markdown с сохранением таблиц, заголовков и списков. Запускается при подготовке файлов для RAG и контекста LLM. CX Codex +1 ★ 1 472звёзд репо oma-market Скилл oma-market собирает сигналы рынка из сообществ и оформляет их в краткий отчёт о болях клиентов, трендах или конкурентах. CX Codex +1 ★ 1 472звёзд репо oma-skill-creator Скилл oma-skill-creator создаёт, форматирует и проверяет скиллы OMA в стандарте SSL-lite с четырьмя обязательными блоками внутри .agents/skills/. CX Codex +1 ★ 1 472звёзд репо oma-frontend Субагент oma-frontend для фронтенда на React, Next.js и TypeScript с архитектурой FSD-lite, shadcn/ui и design-tokens. Ставь, когда работаешь с UI, компонентами, страницами, стилями и клиентской логикой. CX Codex +1 ★ 1 472звёзд репо oma-backend Скилл oma-backend для Claude Code реализует серверные API, аутентификацию и доступ к данным приложения. Включается для задач с эндпоинтами, бизнес-логикой и фоновыми заданиями. CX Codex +1 ★ 1 472звёзд репо oma-recap Скилл oma-recap для Claude Code собирает разговоры с ИИ-инструментами за выбранный период и формирует тематический отчёт по проектам. Помогает подготовить стендап и увидеть распределение работы между инструментами. CX Codex +1 ★ 1 472звёзд репо

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

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