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

sk-brief — скилл для Claude Code: брифы для видео

Скилл sk-brief для Claude Code готовит бриф для короткого видео: формулирует идею, выбирает сюжетный ход и визуальный стиль. Проверка лицензий изображений проходит до написания сценария.

MIT ★ 204 обновлён 2026-11-09

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

Что делает sk-brief

Скилл собирает основу короткого видео и записывает её в briefs/<id>.md. Он формулирует идею одним предложением, проверяет факты в docs/facts/facts.json, выбирает сюжетный ход и визуальные типы, а для каждого изображения или клипа фиксирует лицензию в docs/facts/sources.json.

Затем скилл создаёт папку командой bun run new <id> --flow <A..N>, задаёт визуальные типы в src/videos/<id>/narration.json и заполняет бриф по briefs/_template.md. Перед работой нужны файлы проекта shorts-kit и установленный bun; для фактов, которых нет в реестре, запускается sk-facts. Следующий этап — sk-narration.

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

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

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

  • Подготовь бриф для короткого видео о X и выбери подходящий сюжетный ход.
  • Создай папку для нового видео и заполни briefs/<id>.md.
  • Проверь, можно ли использовать это изображение, и запиши его лицензию.

Как установить sk-brief

1Через Skills CLI (Vercel)

npx skills add howznguyen/shorts-kit --skill sk-brief -a claude-code

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

~/.claude/skills/sk-brief/SKILL.md

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

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

Вопросы о sk-brief

Как установить sk-brief в Claude Code?

Запусти npx skills add howznguyen/shorts-kit --skill sk-brief -a claude-code. Файл скилла находится по пути ~/.claude/skills/sk-brief/SKILL.md.

Что делает sk-brief?

Он готовит бриф короткого видео: формулирует идею, подбирает сюжетный ход и визуальные типы, сверяет факты и записывает лицензии изображений до написания сценария.

Что нужно для работы sk-brief?

Нужны файлы проекта shorts-kit и bun для команды bun run new <id> --flow <A..N>. Если нужных фактов ещё нет в docs/facts/facts.json, скилл запускает sk-facts.

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

SKILL.md · MIT
---
name: sk-brief
description: Starts a new short by stating the idea in one sentence, picking the storytelling flow and the visual types, checking image licences before any script exists, scaffolding the video folder, and writing briefs/<id>.md. Use when the user says "new video about X", "write a brief", "which flow fits this topic", "how should this look on screen", "scaffold a video", or "can I use this image". Steps 1, 3 and 4 of sk-pipeline.
---

# sk-brief: idea, flow, visuals, brief

**Announce:** "Using sk-brief for <id>."

Rules: `SOUL.md` three first rules, §1, §2 (`docs/soul/01-voice-and-structure.md`),
§5 (`docs/soul/03-visuals.md`), §13 (`docs/soul/10-files.md`). The § wins over
this file.

## Order (do not swap)

1. **One sentence: what can the viewer repeat after watching?** If you cannot
   write it, the topic is not ready. This sentence is the brief's first line.
2. **Facts first.** Every claim you plan to use needs a `verified` record in
   `docs/facts/facts.json`. Missing ones: run `sk-facts` now, before writing.
3. **Pick the flow.** Read `docs/flows/README.md`, then the candidate flow files,
   especially "When to use" and "Traps". Do not default to the first flow out of
   habit: ask what shape the fact has (a list of reasons, a trace back to a cause,
   a single person, a comparison). Sketch at least two shapes, pick one, and note
   in the brief why the other lost.
4. **Pick the visual types** from `docs/visuals/README.md` (e.g. `text-as-image`,
   `timeline`, `archive-plate`, `news-photo`, `gif`, `b-roll`) and read each
   chosen type's file. Flow is how the story is told; visual is how it gets on
   screen. They are independent axes.
5. **Check the licence of every image and clip now.** Record each in
   `docs/facts/sources.json` with its `licence`. An image you cannot license is a
   claim you cannot show; find another visual or cut the claim before scripting.
6. **Scaffold:**
   ```bash
   bun run new <id> --flow <A..N>
   ```
   Then set `visual` in `src/videos/<id>/narration.json` to the chosen ids.
   `id` follows §13 (lowercase, hyphenated, never reused for a different video).
7. **Write `briefs/<id>.md`** from `briefs/_template.md`.

## What the brief holds

- The one-sentence idea and the angle (what the viewer believes now, and the
  turn that negates it).
- Flow chosen, why, and the shape that was rejected.
- Visual types and, per scene, what is on screen.
- A fact table that points at **ids** (`f-0001`), not copied numbers or URLs. A
  copied number goes stale silently when the ledger is corrected.
- Image list with source ids and licences.
- An empty "Posted" section, filled in after upload (`sk-improve`).

## Verify

- [ ] `flow` in `narration.json` matches the flow named in the brief
- [ ] `visual` is set and every id exists in `docs/visuals/`
- [ ] every fact id in the brief exists in `docs/facts/facts.json`
- [ ] every image has a source record with a licence
- [ ] `bun run facts` exits clean

Next: `sk-narration`.

© howznguyen · MIT · howznguyen/shorts-kit

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

Все скиллы по теме «Маркетинг и контент» →
music-supervision-scoring calesthio Скилл music-supervision-scoring для Claude Code помогает спланировать музыку и звуковое сопровождение для видео. Он подключается к задачам подбора, лицензирования и проверки музыки. CX Codex +1 263установок script-writing vivy-yi Скилл script-writing для Claude Code помогает строить сценарии роликов, прямых эфиров и каруселей для Xiaohongshu. Он подключается к задаче, когда нужно разложить историю по этапам и удержать внимание зрителей. CX Codex +1 247установок brand-launch-film-production calesthio Скилл brand-launch-film-production для Claude Code помогает спланировать и подготовить фильм к запуску бренда. Он подключается к задачам от разработки концепции до проверки и подготовки версий для разных площадок. CX Codex +1 167установок short-form-video iart-ai Скилл short-form-video для вертикальных Reels, TikTok и Shorts: выстраивает хук, ритм склеек и петлю так, чтобы зритель не свайпнул на первой секунде. CX Codex +1 5 100установок muapi-youtube-shorts SamurAIGPT Скилл muapi-youtube-shorts для Claude Code и других агентов: нарезает длинное видео на вертикальные клипы 9:16 с оценкой виральности и авто-кропом по лицу. Из подкаста или стрима выходят готовые Shorts, TikTok и Reels. CX Codex +1 2 900установок muapi-ai-clipping SamurAIGPT Скилл muapi-ai-clipping для Claude Code нарезает длинное видео на короткие вертикальные ролики. Запускается по просьбе выделить лучшие фрагменты из видео. CX Codex +1 2 800установок

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

Весь набор →
sk-style Скилл sk-style для Claude Code правит формулировки в устном сценарии короткого видео, сохраняя смысл. Запускается по просьбе сделать текст короче, живее или убрать фразы, похожие на машинные. CX Codex +1 ★ 204звёзд репо sk-render Скилл sk-render для Claude Code рендерит короткие видео в MP4, нормализует громкость и готовит файл к загрузке. Запускается по просьбам отрендерить ролик, исправить тихий звук или проверить повреждённый файл. CX Codex +1 ★ 204звёзд репо sk-facts Скилл sk-facts для Claude Code проверяет фактические утверждения и сохраняет результаты исследования в реестр. Включается для поиска источника, проверки числа или лицензии изображения. CX Codex +1 ★ 204звёзд репо sk-narration Скилл sk-narration для Claude Code пишет и правит сценарий короткого видео, создаёт озвучку и запускает проверку. Срабатывает на просьбы изменить текст, произношение или голос, а также на ошибки проверки сценария. CX Codex +1 ★ 204звёзд репо sk-handoff Скилл sk-handoff для Claude Code готовит обложку, файл для загрузки, подпись и закреплённый комментарий к короткому видео. Запускается по просьбе подготовить ролик к публикации или сделать обложку, подпись либо кредиты. CX Codex +1 ★ 204звёзд репо sk-scene Скилл sk-scene для Claude Code собирает и правит визуальные сцены коротких видео в Remotion. Запускается при запросах собрать кадры, поправить подпись, анимацию или компоновку. CX Codex +1 ★ 204звёзд репо sk-promo Скилл sk-promo для Claude Code создаёт рекламные ролики, тизеры и фильмы о запуске продукта. Задаёт формат 9:16 или 16:9 и проводит проект через сценарий, раскадровку, проверку и экспорт. CX Codex +1 ★ 204звёзд репо sk-pipeline Скилл sk-pipeline для Claude Code ведёт вертикальный ролик от идеи до файлов для публикации. Включается при создании нового видео, монтаже исходников или продолжении незавершённого проекта. CX Codex +1 ★ 204звёзд репо

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

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