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

sk-promo — скилл для Claude Code: проморолики и установка

Скилл sk-promo для Claude Code создаёт рекламные ролики, тизеры и фильмы о запуске продукта. Задаёт формат 9:16 или 16:9 и проводит проект через сценарий, раскадровку, проверку и экспорт.

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

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

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

Скилл sk-promo помогает собрать рекламный ролик или тизер продукта в формате 9:16 либо 16:9. Он начинает с задачи ролика и проблемы аудитории, затем формирует концепции и раскадровку; до написания сцен нужно утвердить сценарную обработку и черновой монтаж-аниматик.

Ролик можно сделать без озвучки или с голосом. Для первого создаётся promo.json с длительностью сцен и музыкой; для второго используется sk-narration. Скилл включает проверки кадров, рендера и готовых версий ролика. Лицензии материалов, которые не проверены, ограничивают фильм внутренним использованием; публикацию он не выполняет автоматически.

Видеоматериалы для альбомного формата пока не поддерживаются командами ingest и cut. Некоторые компоненты тоже рассчитаны только на вертикальное видео, поэтому их проверяют отдельно для 16:9.

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

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

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

  • Сделай рекламный ролик о запуске продукта в формате 16:9.
  • Подготовь промо без озвучки, только с музыкой и звуковыми эффектами.
  • Собери вертикальную рекламу с голосом и несколькими короткими версиями.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о sk-promo

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

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

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

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

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

Для ролика без голоса задают время сцен и музыку в promo.json. Для версии с голосом используют sk-narration и сценарный поток.

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

SKILL.md · MIT
---
name: sk-promo
description: Makes an ad, TVC, product launch film or feature teaser as a promo, either vertical 9:16 or landscape 16:9, using video.json format and mode. Use when the user says "make an ad", "TVC", "commercial", "product video", "launch film", "promo", "teaser", "quảng cáo", "làm video giới thiệu sản phẩm", "video ngang", "16:9", "landscape", or asks for a video that sells or announces something rather than explains a fact. Not for narrated knowledge shorts (use sk-pipeline).
---

# sk-promo: an ad or TVC, vertical or landscape

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

A promo sells or announces; a short explains a fact. A promo **starts from the pain of the people who use the product** and reveals the product as the answer; a feature tour is not a promo. They share the engine and
differ in rules. Rules: `docs/promo/README.md` (read it first). SOUL's story rules
do not apply; its hard rules do (licences, encode spec, never auto-publish).

## Voice or no voice

- **No voice** (music and sfx, like a TVC): `bun run new <id> --voice none`. The clock
  is `promo.json` (seconds or beats). No narration, TTS, facts file or flow. See
  "A promo with no voice" in `docs/promo/README.md`.
- **Voice-over**: `bun run new <id> --flow <X> --mode promo`, then the normal
  narration path (`sk-narration`).

Read "What is not built yet" in `docs/promo/README.md` and tell the user which of
those their film needs **before** starting (no beat measurement, no strip review,
no page capture yet).

## Steps

| # | Step | How | Evidence |
|---|---|---|---|
| 0 | **Objective and placement.** Copy `briefs/_template-promo.md` to `briefs/<id>.md`. Fill objective, the one measure, CTA (exact words), mandatories, placement (feed ad or launch film) and the deliverables matrix (master, cutdowns, formats, captions) | `docs/promo/README.md` rules 11, 12, 15 | those sections filled and confirmed by the owner |
| 1 | **Pain point first.** Write, in the target user's own words: who they are, the moment they feel the pain, what it costs them. The owner confirms it before anything else is designed. Then the format (portrait or landscape) from where it is watched | `docs/promo/README.md` rules 0 and 1 | pain point written in the brief and confirmed |
| 1a | **Concept routes:** 2-3 routes, each one sentence + key frame + how it shows the pain. The owner picks one; rejected routes and why stay in the brief | `docs/promo/README.md` rule 13 | the chosen route and the rejected ones written |
| 1b | **Treatment, confirmed before any build:** scene by scene in plain words, what the viewer should understand at the end of each (`docs/promo/aesthetics.md` C1-C8): one idea per scene, plain words before product words, a before and after, labels on every number | `docs/promo/aesthetics.md` Clarity | the owner confirmed the treatment |
| 2 | Brief: one sentence, shot list, every asset and its licence. A licence that is not checked makes the film internal-only, and the brief says so at the top | `sk-brief` (skip the flow's "turn" rule) | `briefs/<id>.md` |
| 3 | Scaffold | no voice: `bun run new <id> --voice none --format <portrait\|landscape>`; voice-over: `bun run new <id> --flow <X> --format <..> --mode promo` | `src/videos/<id>/video.json` (+ `promo.json`) |
| 4 | No voice: write `promo.json` (scenes in seconds or beats, music, `bpm` measured, not guessed). Voice-over: write the words | no voice: `docs/promo/README.md`; voice-over: `sk-narration`, and `sk-facts` only for checkable claims (prices, numbers, "first", "only") | `bun run lint <id>` 0 errors |
| 5 | Shot list approved before scene code; every shot has a `size`, and a `card` from `docs/shots/` where one fits | `bun run storyboard <id> --init` (no voice: one shot per promo.json scene, split by `beat`; voice-over: one per line), `docs/storyboard.md`, review in `bun run preview` (Storyboard and Timeline tabs) | every shot `approved` |
| 5a | **Animatic gate:** full-length timed rough cut (one plain card per scene: its big type and a box or still), real music on the grid, scratch voice if voiced. Render it, the owner watches at full speed, and someone new takes the "before" comprehension test (C8). No scene code until it passes | `docs/promo/README.md` rule 14 | animatic rendered; the owner's OK and the stranger's answer written in the brief |
| 6 | Scenes | `sk-scene`; real product components: `docs/promo/real-ui.md`; size and safe area from `useFormat()` / `safeFor()` in `src/shared/format.ts`, never the `W` and `H` in `theme.ts` | `bun run check` clean |
| 7 | Stills with the safe overlay | `bun run still <id> --frame=<n> --safe` | stills opened and looked at |
| 8 | Render, normalize, encode | `sk-render` (size is checked against the video's own format) | ffprobe passes |
| 8a | **Comprehension test:** show the cut to someone who has not seen it; ask what it is for and what changes if you use it; write their answer in the brief (C8) | `docs/promo/aesthetics.md` | their answer names the pain, the product and the benefit |
| 8b | **Review pass:** every rule in `docs/promo/aesthetics.md` answered `✓` or `✗ (shot/frame)`, from a contact strip, ideally by a reviewer who did not make the film; each deliberate break written in the brief | `docs/promo/aesthetics.md` | the pass is written down |
| 8c | **Cutdowns and formats** from the deliverables matrix: each re-edited (pain, product, CTA in its own length), its own composition, checked like the master | `docs/promo/README.md` rule 15 | every row of the matrix has a file that passes ffprobe |
| 9 | Hand-off | `sk-handoff` (a 16:9 cover is not cropped; the 1:1.29 grid crop is for portrait) | every file in the deliverables matrix is in `out/<id>/` |

## Traps

- Components that still import `W`/`H` from `theme.ts` (map, nature, marks, figures,
  chart, FootageStage, PipShot) are portrait only. In a landscape video, check each
  on a still, or make it format-aware with `useFormat()` first.
- The template's `scenes.tsx` uses portrait safe-zone constants. For landscape use
  `safeFor("landscape")`.
- Voiced promo: `bun run lint` still applies the short rules to narration; read its
  warnings as advice, not gates. Voiceless promo: lint checks only the clock and files.
- `bun run render` renders only the `Video` composition; render a cutdown with `bunx remotion
  render` (see "What is not built yet").
- A feed ad that opens on the pain still needs the product name or mark visible by 5 s (rule 12).
- `ingest`/`cut` normalise footage to 1080×1920; landscape footage is not
  supported yet.
- Never auto-publish.

© howznguyen · MIT · howznguyen/shorts-kit

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

Все скиллы по теме «Маркетинг и контент» →
newsletter-promo charlie947 Скилл newsletter-promo собирает 12–20-секундный промо-клип для LinkedIn, Instagram или X из одного выпуска рассылки: хук, три кадра-доказательства и финальная карточка. CX Codex +1 3 200установок brand-promo-video-generator MiniMax-AI Скилл brand-promo-video-generator для Claude Code собирает короткие промо-ролики бренда, продукта или приложения из логотипов, скриншотов и ссылок. Создаёт ролики для запусков и соцсетей. CX Codex +1 3 700установок promo-video OpusGameLabs Скилл promo-video записывает плавное промо-видео Phaser-игры в портретной ориентации 9:16 с частотой 50 FPS через Chrome DevTools Protocol и FFmpeg. CX Codex +1 953установок record-promo OpusGameLabs Скилл record-promo записывает автономное геймплейное видео игры в 50 FPS для TikTok, Reels или X. Скилл сам управляет игрой и сохраняет готовый MP4. CX Codex +1 939установок promo-writer bitwize-music-studio Скилл promo-writer генерирует тексты для продвижения альбома в соцсетях с учётом формата каждой платформы. Пригодится перед релизом, когда шаблоны promo/ нужно заполнить. CX Codex +1 259установок minimalist-product-ad-generator MiniMax-AI Скилл minimalist-product-ad-generator для Claude Code превращает изображения товара и требования к рекламе в минималистичный ролик. Он помогает подготовить текст и раскадровку для запуска продукта или продвижения в электронной торговле. CX Codex +1 3 600установок

Из того же набора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-pipeline Скилл sk-pipeline для Claude Code ведёт вертикальный ролик от идеи до файлов для публикации. Включается при создании нового видео, монтаже исходников или продолжении незавершённого проекта. CX Codex +1 ★ 204звёзд репо sk-improve Скилл sk-improve для Claude Code меняет правила и сценарии канала, а не готовый ролик. Он включается при настройке набора для нового канала, разборе статистики опубликованного видео или правке правила. CX Codex +1 ★ 204звёзд репо

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

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