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

media-use · coco-research — скилл для Claude Code: медиа в HyperFrames-проекте

Скилл media-use собирает музыку, звуки, иконки и логотипы для проекта HyperFrames, озвучивает текст и правит кадры.

MIT ★ 328 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add coco-research/coco --skill media-use -a claude-code
Открыть на GitHub

Что делает media-use

Скилл закрывает медиа в проекте HyperFrames одним глаголом resolve: указываете тип и описание, получаете строку resolved <id> → <path> и локальный файл. Типы: bgm, sfx, image, icon, logo, voice, grade, lut. Музыка и картинки берутся из каталога HeyGen, звуки — из встроенной библиотеки на 19 файлов, логотипы ищутся по цепочке svgl → simple-icons → GitHub avatar → favicon и вручную не перерисовываются.

Если в каталоге ничего подходящего нет, скилл генерирует материал моделями TTS, музыки или изображений. Озвучка, транскрипция, субтитры и удаление фона идут через общий аудио-движок, а для готовых файлов есть обрезка, перекадрирование и трансформация. Перед новым поиском скилл советует запросить --candidates: так видно ассеты из прошлых проектов, которые можно переиспользовать.

Первый запуск упирается в heygen CLI: его нужно установить и войти в аккаунт, иначе resolve не заработает. Проверка — node <SKILL_DIR>/scripts/resolve.mjs --doctor, настройка провайдеров описана в references/setup-providers.md. Размытые жалобы на реальные кадры (тёмно, плоско, скучно, хочется плёнки или ASCII) скилл читает как запрос на медиа-обработку и ведёт по references/media-treatments.md.

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

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

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

  • Найди bgm под сцену-вступление и положи файл в проект
  • Озвучь текст из сценария и сделай субтитры
  • Замени эмодзи в блоке на настоящие иконки из каталога

Как установить media-use

1Через Skills CLI (Vercel)

npx skills add coco-research/coco --skill media-use -a claude-code

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

~/.claude/skills/media-use/SKILL.md

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

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

Вопросы о media-use

Как установить media-use в Claude Code?

Выполните npx skills add coco-research/coco --skill media-use -a claude-code. Файл скилла окажется в ~/.claude/skills/media-use/SKILL.md.

Что делает media-use?

Закрывает медиа в HyperFrames: находит музыку, звуки, картинки, иконки, логотипы и голос через resolve, при промахе каталога включает генерацию, а ещё правит готовые файлы и делает озвучку с субтитрами.

Что нужно для первого запуска?

Установить heygen CLI и войти в него, затем проверить окружение командой node <SKILL_DIR>/scripts/resolve.mjs --doctor.

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

SKILL.md · MIT
---
name: media-use
description: Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.
---

# media-use

The media OS for HyperFrames: resolve · generate · operate · remember — every media type, one skill, zero context noise.

First run: install and sign in to the `heygen` CLI (the free-usage path), then verify with `node <SKILL_DIR>/scripts/resolve.mjs --doctor`. Setup and providers: `references/setup-providers.md`.

## Resolve — the one verb

```bash
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
```

Returns one line: `resolved <id> → <path> (<type>, <metadata>)`. All search noise stays on disk.

| Type    | One-line intent                                                                     |
| ------- | ----------------------------------------------------------------------------------- |
| `bgm`   | background music (HeyGen catalog, 10k+ tracks)                                      |
| `sfx`   | sound effects (bundled 19-file library + catalog)                                   |
| `image` | photos, backgrounds (HeyGen asset search, 75k+ vectors)                             |
| `icon`  | icons, symbols (transparent)                                                        |
| `logo`  | official brand marks (svgl → simple-icons → GitHub avatar → favicon; never redrawn) |
| `voice` | TTS voiceover (HeyGen free-usage path; optional local Kokoro)                       |
| `grade` | measured correction candidate; broad polish/stylization follows Media Treatments    |
| `lut`   | user-provided or explicitly chosen reusable validated `.cube` file                  |

Before resolving fresh, list reusable candidates with `--candidates` and judge fit yourself — reuse rules, all flags, ingest (`--from`), and adopt are in `references/resolve.md`.

## Treat broad visual feedback as media intent

When a user explicitly asks to fix, polish, stylize, obscure, emphasize, or
reveal photographic media, read `references/media-treatments.md` even if they
do not name color grading or an effect. Inspect the real `<img>`/`<video>`,
choose one primary intent, then use deterministic persistence and verification.
Use a matching recipe as an optional tested seed, or inspect
`hyperframes media-treatment --capabilities --json`, then request one relevant
family/effect with `--capability <id>` and assemble a custom treatment from
canonical controls. Never load `--all` for ordinary authoring. A treatment may
compose correction, a preset, finishing, compatible shader effects, supported
keyframes, and optional Registry overlays. Add only source-justified bounded
tuning and compatible parts, never effects merely to make the result look more
sophisticated. Persist the final combined payload with
`hyperframes media-treatment`.

Use one progressively escalating workflow. For video, inspect one labeled
early/middle/late contact sheet rather than reading frames separately. Apply one
candidate and inspect one after-sheet for ordinary correction or polish.
Escalate to individual frames or moving draft evidence only when the result is
ambiguous, temporal, stylized, LUT-based, HDR/LOG-sensitive, private, or
brand-critical.

For ordinary correction or polish, persist the final treatment's
preset/adjustment JSON.
Do not generate a `.cube` LUT merely to encode exposure, shadows, contrast, or
warmth. Use a LUT only when the user supplies one or the selected treatment
explicitly owns one. `resolve --type grade --for ... --analyze` is measurement
evidence, not permission to replace the chosen treatment with a generated LUT.
Do not recreate supported vignette, grain, blur, pixelate, color, or treatment
effects with CSS/SVG overlays; that bypasses Studio controls and the canonical
preview/render shader path.

## Be proactive — run a media opportunity pass

The human usually can't tell which media would lift the piece. You can. When you build or review a composition, do **one** grounded scan and then **ask once** — don't silently add, and don't nag per asset.

Surface an opportunity only when a concrete signal is present:

| Signal detected                                          | Offer                                                                                                  |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| On-screen text / a script with no voiceover              | TTS voiceover (audio engine)                                                                           |
| Emoji or a `<div>` styled as an icon                     | resolve real `icon`s                                                                                   |
| Image that is a placeholder, tiny, or upscaled-looking   | a better `image` (and/or upscale — see `references/operations.md`)                                     |
| Hard scene cuts / transitions with no sound              | transition `sfx`                                                                                       |
| A piece over ~10s with no music bed                      | `bgm`                                                                                                  |
| Footage that reads under/over-exposed or color-cast      | a corrective grade (inspect it with `hyperframes media-treatment --selector '#hero' --analyze --json`) |
| Photographic media that feels visually flat or off-topic | one specific source-appropriate preset or custom treatment, with the intended target named             |
| A meaningful media entrance/reveal that feels static     | one supported seek-safe treatment animation; preserve color unless the request also justifies a preset |

Rules that keep this a help, not nagware: **grounded, not generic** (no signal → no suggestion); **opinionated + concrete** (propose the specific fix with defaults chosen — the human approves **all / some / none**); **once per project** (one consolidated ask; respect "leave it"); **surface, never silently mutate** (color grades especially: propose and preview — a gray-world "correction" ruins an intentional sunset or neon look).

## Where to look — read only the file your task needs

| Task                                                                      | Read                             |
| ------------------------------------------------------------------------- | -------------------------------- |
| resolve / reuse / adopt / ingest, flags, cascade, inventory               | `references/resolve.md`          |
| color grading, LUTs, smart grade (`--for`), grade-compare                 | `references/grading.md`          |
| voiceover / TTS, music, SFX, captions, transcription (audio engine)       | `references/audio.md`            |
| cut / reframe / transform existing media, exact error diffusion, HEVC     | `references/operations.md`       |
| source-aware creative treatments, realtime effects, overlays, reveals     | `references/media-treatments.md` |
| install + auth, provider table, RAM ladders, `--local-only`, `--provider` | `references/setup-providers.md`  |
| remembered preferences + frozen recipes (user memory)                     | `references/memory.md`           |
| ownership matrix, usage stats, telemetry, privacy (maintainer-facing)     | `references/meta.md`             |

© coco-research · MIT · coco-research/coco

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

Все скиллы по теме «Дизайн» →

Сначала — media-use от других авторов.

media-use heygen-com Скилл media-use ищет и генерирует медиафайлы для видеопроектов HyperFrames, сохраняя их локально в папку assets. Подключает каталог HeyGen, озвучку, фоновую музыку и цветовую коррекцию видео. CX Codex +1 1 500 000установок generated-media-qa calesthio Скилл generated-media-qa для Claude Code проводит проверку качества медиафайлов, созданных или изменённых с помощью ИИ. Запускается при проверке, приёмке и разборе изображений, видео и аудио. CX Codex +1 261установок hyperframes-media boraoztunc Скилл hyperframes-media для Claude Code готовит медиа для композиций HyperFrames: озвучивает текст, транскрибирует аудио и видео с таймстампами и удаляет фон. CX Codex +1 218установок od-next-media-inputs nexu-io Скилл od-next-media-inputs готовит медиа-входы по уже замороженному плану OD Next: находит стоковые фото, скачивает их в проект и держит слоты в рамках требований к качеству. CX Codex +1 508установок media-qc-delivery calesthio Скилл media-qc-delivery для Claude Code проверяет качество медиафайлов и задаёт требования к экспорту перед финальной передачей на платформу или клиенту. CX Codex +1 214установок pixelbin-media nexu-io Скилл pixelbin-media для Claude Code: генерация и редактирование изображений и видео через Pixelbin, сборка страниц сайта. Создаёт и трансформирует медиа по ходу работы агента. CX Codex +1 2 900установок remotion-asset-coordinator ncklrs Скилл remotion-asset-coordinator парсит спецификации моушн-дизайна, подбирает форматы медиафайлов и создаёт готовый код импорта staticFile для Remotion. CX Codex +1 184установок

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

Весь набор →
maker-mdap Скилл maker-mdap помогает проектировать длинные цепочки действий LLM через декомпозицию, голосование и отсев подозрительных ответов. CX Codex +1 ★ 328звёзд репо arch Команда для построения и проверки .arch/index.json — карты, которая связывает каждый компонент архитектуры с файлами, которые его реализуют. Находит, когда файлы и описание компонентов перестали совпадать. CX Codex +1 ★ 328звёзд репо develop Команда develop запускает многоагентный пайплайн разработки и исправления кода с разделением файлов между агентами и обязательной проверкой регрессий. CX Codex +1 ★ 328звёзд репо data-specialist Субагент data-specialist для исследовательского анализа данных, машинного обучения и оптимизации SQL-запросов под PostgreSQL, MySQL, SQL Server и Oracle. CX Codex ★ 328звёзд репо brain:init Скилл brain:init для Claude Code создаёт в каталоге проекта базу знаний project_brain.db и наполняет её данными из заметок, документации и истории решений. CX Codex +1 ★ 328звёзд репо pmstudio-sync Скилл pmstudio-sync переносит изменения из исходных файлов в связанные PRD, презентации и заметки. Он показывает предлагаемые правки и ждёт одобрения. CX Codex +1 ★ 328звёзд репо agent-lightning Скилл-справка по фреймворку Agent Lightning: как подключить сбор трейсов к агенту, поднять хранилище и прогнать обучение с подкреплением или оптимизацию промптов. CX Codex +1 ★ 328звёзд репо sync-init Команда sync-init настраивает автоматическую синхронизацию проекта каждые 2 часа: ищет письма в Outlook, отслеживает файлы и обновляет документы через Claude CLI. CX Codex +1 ★ 328звёзд репо

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

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