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

sk-pipeline — скилл для Claude Code: видео по шагам

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

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

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

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

sk-pipeline задаёт порядок работы над озвученным вертикальным роликом: от идеи, проверки фактов и сценария до монтажа, обложки и файлов для публикации. На каждом этапе он указывает нужный скилл и раздел правил в SOUL.md; команды собраны в docs/making-a-video.md.

Для записанного голоса порядок меняется: проект начинает с импорта записи и расшифровки через Whisper, затем обрабатывает фрагменты. Результаты этапов проверяют по файлам на диске, просматривая кадры и прослушивая звук. Публикация остаётся ручной: пайплайн заканчивается файлами в out/<id>/ и не запускает загрузку.

Скилл предназначен для озвученных вертикальных роликов. Для рекламы, продуктового видео и формата 16:9 в инструкции указан sk-promo; при --format landscape правила SOUL.md остаются рассчитаны на 9:16, и часть компонентов может неверно расположить контент.

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

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

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

  • Создай короткое озвученное видео об истории проекта.
  • Продолжи работу над видео launch и скажи, какой этап следующий.
  • Смонтируй видео из source.mov и подготовь файлы для публикации.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о sk-pipeline

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

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

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

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

Загрузит ли sk-pipeline готовое видео?

Нет. Пайплайн завершает работу файлами в out/<id>/; пользователь загружает видео вручную.

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

SKILL.md · MIT
---
name: sk-pipeline
description: Orchestrates one narrated vertical short (TikTok, YouTube Shorts, Reels) from idea to upload-ready hand-off files, in the fixed order idea, facts, flow and visual choice, brief, narration, TTS, lint, scenes, still review, render, cover, normalize, encode, hand-off. Use when the user says "make a video about X", "start a new short", "take this idea to a finished video", "what's the next step", "where was I on this video", or asks how the whole pipeline fits together. Also when the user gives a video or audio file (or a folder of clips) to edit: "edit this video", "dựng video này", a .mov/.mp4 path. Points at the skill and the SOUL section that governs each step.
---

# sk-pipeline: one video, idea to hand-off

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

## Route first: short or promo?

This skill is for narrated knowledge shorts. If the user wants an **ad, TVC,
commercial, product or launch video, teaser, or any landscape (16:9) video**, use
`sk-promo` instead; it has its own rules (`docs/promo/README.md`). A short can still be
scaffolded with `--format landscape`, but then say plainly that SOUL's rules were
written for 9:16 and that components not yet format-aware may misplace content.

## This skill is not the rules

The rules live in `SOUL.md` and `docs/soul/`. This skill only fixes the **order**
and points at the skill and § for each step. Where it disagrees with a §, the §
wins and this file is the one to fix. Do not copy rules into skills: two copies
drift and nobody knows which is current.

Read `SOUL.md` first (index, three first rules, pipeline order, checklist). It
holds this channel's editable defaults; changing them is `sk-improve`'s job. Then
open only the § for the step you are on; do not load the whole of `docs/soul/`.
Exact commands per step are in `docs/making-a-video.md`.

## The steps

| # | Step | Skill | Rules | Evidence on disk before moving on |
|---|---|---|---|---|
| 0 | If `SOUL.md`'s change log has no entries, the rules were never adapted: offer first-run setup | `sk-improve` | `SOUL.md` | change log has entries, or user declined |
| 1 | Idea: one sentence the viewer can repeat after watching | `sk-brief` | §1 | sentence written in the brief |
| 2 | Facts: every claim sourced and recorded | `sk-facts` | §9 | `bun run facts` clean |
| 3 | Flow + visual choice, image licences checked | `sk-brief` | §2, §5, `docs/flows/`, `docs/visuals/` | `bun run new <id> --flow <X>` done |
| 4 | Brief | `sk-brief` | §2, §5 | `briefs/<id>.md` with fact ids |
| 5 | Narration | `sk-narration` (polish: `sk-style`) | §1, §3, §3b, §3c | `src/videos/<id>/narration.json` |
| 6 | TTS | `sk-narration` | §4 | `voice.json` + `public/audio/<id>/voice.mp3`, listened to |
| 7 | Lint | `sk-narration` | `docs/soul/thresholds.json` | `bun run lint <id>` 0 errors, warnings read |
| 7b | Storyboard: one row per camera shot, approved by the user before any scene code | `sk-scene` | §12, `docs/storyboard.md` | `bun run storyboard <id>` clean, shots `approved` |
| 8 | Scenes (+ optional SFX, `docs/shots/sfx/`) | `sk-scene` | §5, §6, §7, §8, §12, §13 | `bun run check` clean |
| 9 | Still review | `sk-scene` | §7 | stills in `out/<id>/` opened and looked at |
| 10 | Render | `sk-render` | §11 | `out/<id>/<id>.mp4`, frames checked |
| 11 | Cover | `sk-handoff` | §10 | `out/<id>/<id>-cover.png` checked at 200 px |
| 12 | Normalize | `sk-render` | §8 | `out/<id>/<id>-loud.mp4`, loudness measured |
| 13 | Encode | `sk-render` | §11 | `out/<id>/<id>-upload.mp4`, ffprobe checked |
| 14 | Hand-off | `sk-handoff` | §10, §11 | caption, pinned comment, credits in `out/<id>/` |

### A recorded voice instead of TTS (§5j)

When the user brings a recording (a filmed take, several clips, or a voice-only audio
file), the voice is what was said, not written. Start with `bun run from <file|dir>...`:
it does steps 3, 5a and 5b below in one go and prints what to ask the speaker. Steps 5 and 6 become **ingest** and **cut**; the rest
keeps its order:

| # | Step | Command | Evidence |
|---|---|---|---|
| 3 | Flow + visual: `talking-head` shows the take; any other visual uses only its audio | `bun run new <id> --flow <X> --visual talking-head` or `--visual <type> --voice recorded` | `narration.json` voice.engine `recorded` |
| 5a | Ingest: normalise, Whisper transcript, proposed cuts | `bun run ingest <id> <file> --lang <code> [--prompt "names"]` | `transcript.json`, review read, every `⟪words missing?⟫` heard |
| 5b | Cut: edit `cuts.json` (reasons), fix misheard words with `spelling`, never retype a line | `bun run cut <id>` | `footage.json`, `voice.mp3` listened to end to end |
| 2 | Facts, AFTER the transcript: every claim said is verified, cut, or `"claim": false` | `sk-facts` | lint has no "cites no fact" error |

Ask the user for the exact words wherever Whisper is unsure (`?` in the review, numbers,
names, `⟪words missing?⟫`): an agent cannot hear the take, and Whisper writes what it
expects. Then regroup lines into the flow's beats, declare `face` for talking-head, and
continue at step 7.

The step list the preview shows lives in `docs/pipeline.json`. A channel that adds, removes or reorders a step changes it there (with `sk-improve`), and the preview follows.

After the user has posted and has numbers: `sk-improve`.

## Three orderings that are rules, not habits

1. **Facts before words** (step 2 before step 5). No sentence is written before
   its claim has a `verified` record. Writing first and sourcing later is how a
   good-sounding sentence survives with no source behind it.
2. **Visual language before words** (step 3 before step 5). Decide how each
   claim gets on screen, and check the licence of every image, before scripting.
   A script built around an image you may not use has to be rewritten.
3. **Script is final before TTS, TTS before scenes.** Scene length comes from the
   real voice track, never set by hand. Editing text after TTS means running TTS
   again, or captions drift silently.

## The cross-cutting principle

**A step is done when there is evidence on disk, not when the command exits 0.**
This pipeline fails silently: an mp4 that exits 0 but is truncated, a still that
renders but has text under the platform UI, a voice track that loops a phrase.
Open the file, look at the frame, listen to the audio.

## Hard limits

- **Never auto-publish.** The pipeline ends at files in `out/<id>/`. The user
  uploads by hand. Do not write or run upload scripts.
- **Never hand-edit `voice.json`.** It is generated by `bun run tts <id>`
  (or `bun run cut <id>` for a recorded voice).
- **A video never imports another video.** Shared code goes to `src/shared/`.
  `bun run check` enforces this.

## Checklist

Use the pre-hand-off checklist in `SOUL.md`, not a copy of it anywhere else.

## Resuming a video

Look at what exists: `briefs/<id>.md`, `src/videos/<id>/narration.json`,
`voice.json`, `out/<id>/*`. The first missing piece in the table above is the
next step. If `narration.json` is newer than `voice.json`, TTS is stale.

© howznguyen · MIT · howznguyen/shorts-kit

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

Все скиллы по теме «Маркетинг и контент» →
vox-video-director modelstudioai Скилл vox-video-director для Claude Code превращает одну тему в готовое видео в стиле Vox: коллаж-анимацию с озвучкой, музыкой и субтитрами. CX Codex +1 161установок youtube-shorts social-media-skills Скилл youtube-shorts пишет сценарий вертикального ролика под алгоритм Shorts: хук в первые секунды, удержание, ключевой заголовок. Съёмка и монтаж остаются за вами. CX Codex +1 1 700установок captions-and-clipping social-media-skills Скилл captions-and-clipping превращает длинное видео в вертикальные клипы с субтитрами для просмотра без звука. Помогает, когда из подкаста или вебинара нужно сделать Shorts, Reels и TikTok. CX Codex +1 1 400установок opusclip opus-pro Скилл opusclip даёт агенту доступ к OpusClip API: режет длинные видео на короткие клипы и умеет публиковать их в соцсети. CX Codex +1 1установок caption-animation iart-ai Скилл caption-animation для пословной анимации субтитров: слово появляется на своём слоге, активное подсвечивается, текст держится в безопасной зоне 9:16. CX Codex +1 4 300установок openshorts mutonby MCP-сервер openshorts для Claude Code и Codex, который нарезает длинные видео на вертикальные шортсы 9:16 для TikTok, Instagram и YouTube, затем публикует их. Автоматизирует работу с видеоконтентом из подкастов и стримов. CX Codex +1 ★ 9 647звёзд репо

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

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

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