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

sk-narration — скилл для Claude Code: сценарий и озвучка

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

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

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

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

Скилл редактирует src/videos/<id>/narration.json, запускает синтез речи и проверяет сценарий командой bun run lint <id>. Он следует структуре ролика из файла flow: раскладывает реплики по сценам и связывает их с фактами. Для английского по умолчанию выбирает edge, для вьетнамского — vieneu; можно оставить выбранный пользователем движок или подключить ElevenLabs.

Для записанного голоса скилл запускает bun run ingest и bun run cut, затем переносит реплики в сцены. Он обрабатывает слова-паразиты и дубли, а спорные места просит уточнить у пользователя. После изменения текста нужно заново выполнить bun run tts <id>: иначе voice.json останется от старой версии сценария. Если vieneu не установлен, потребуются команды настройки из README.

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

  • написать или отредактировать реплики короткого видео
  • исправить произношение и паузы в синтезированной речи
  • пересоздать озвучку после правки сценария
  • разобрать запись, убрать дубли и слова-паразиты
  • проверить сценарий на ошибки и предупреждения

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

  • Напиши сценарий короткого видео для src/videos/<id>/narration.json.
  • Исправь произношение этого имени и пересоздай озвучку.
  • Обработай мою запись: расшифруй речь и убери слова-паразиты.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о sk-narration

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

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

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

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

Какие движки озвучки использует sk-narration?

По умолчанию для английского используется edge, для вьетнамского — vieneu; ElevenLabs доступен как дополнительный вариант. Если vieneu не установлен, для него нужны команды настройки из README.

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

SKILL.md · MIT
---
name: sk-narration
description: Writes or edits the spoken script of a short in src/videos/<id>/narration.json, generates the voice track with bun run tts (by default Edge for English, VieNeu for Vietnamese; ElevenLabs optional), and runs the machine lint. Use when the user says "write the script", "change this line", "fix the pronunciation", "it reads too fast", "add a pause", "re-run TTS", "change the voice", or when lint reports narration errors. Also the recorded-voice path (bun run ingest, bun run cut): "use my recording", "make it from my video", "I filmed myself", "transcribe this", "cut the ums", "remove the retake", or a .mov/.mp4/.mp3/.wav file given as the voice. Steps 5, 6 and 7 of sk-pipeline.
---

# sk-narration: script, TTS, lint

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

Rules: §1, §3, §3b, §3c (`docs/soul/01-voice-and-structure.md`), §4
(`docs/soul/02-narration-engine.md`), the flow file in `docs/flows/`, numbers in
`docs/soul/thresholds.json`. The § wins over this file.

## Where to edit

Only `src/videos/<id>/narration.json` (schema in
`docs/making-a-video.md`). **Never hand-edit `voice.json`**: it is generated and
carries a hash of the script it was made from.

## A recorded voice (`voice.engine: "recorded"`, §5j)

There is no script to write: the lines come from the recording.
`docs/visuals/talking-head.md` holds the rules; in short:

1. `bun run ingest <id> <file> --lang <code>`; pass `--prompt` with names and terms
   said in the take. Read the review it prints.
2. Edit `cuts.json`: fillers, retakes (keep the **last** attempt), false starts, a
   call to action at the end (`tail`). Every cut has a reason; never cut a word to
   change a sentence's meaning.
3. Ask the user what was actually said wherever the review shows `?`, a number, a
   name or `⟪words missing?⟫`. Put each fix in `spelling` (whole phrase → what was
   said). Never retype `text` and never edit `transcript.json`.
4. `bun run cut <id>`, listen to `public/audio/<id>/voice.mp3`, then move whole
   line objects into the flow's beats and add `fact` (or `"claim": false`).
5. `bun run lint <id>`. Writing-style rules only warn here; the fix is a cut or a
   re-take, not a rewrite.

## Steps

1. **Read the flow file** for this video's `flow`: its beats become scenes, its
   "Traps" are mistakes already made once.
2. **Write scene by scene.** Each line is one idea; a line stating a fact carries
   `"fact": "f-xxxx"`. Hook: a number or claim in the first seconds, without
   giving away the final answer (§3c). Last line of each scene pulls into the
   next. End on the turn that negates what the viewer believed, then a share line
   tied to the content, not a logo or "follow for more" (§1).
3. **Read §3c (tension) before TTS**, not after. Re-recording costs more than
   re-reading.
4. **Write for the engine (§4).**
   - Pauses come from **full stops**. Commas, colons and dashes are nearly silent
     to TTS engines; where the viewer needs a breath, end the sentence.
   - Write numbers the way they should be spoken; put the display form in
     `spelling` (caption-only) and respellings in `pronounce` (spoken-only).
   - Silence between lines and scenes comes from `pause.line` / `pause.scene`,
     not from punctuation tricks.
5. **Engine default by language** (§4, "Pick the engine by language"): when the
   user has not chosen an engine, use English → `edge`, Vietnamese → `vieneu`, and
   say which one you used. It is a default, not a rule: an engine the user picked
   stays. If `vieneu` is not installed, give them the setup commands from the README.
6. **Generate the voice:**
   ```bash
   bun run tts <id>            # whole script in one request, word timestamps
   bun run tts <id> --force    # re-synthesise even if the hash matches
   ```
   The whole script is read in one pass so intonation carries across sentences;
   per-line synthesis sounds like a list.
7. **Listen to the whole track.** TTS engines can repeat or loop a phrase, and
   that passes every numeric check. Machines count words; only ears catch rhythm.
8. **Lint:**
   ```bash
   bun run lint <id>
   ```
   0 errors, and read every warning. Duration against `maxDurationSeconds` and
   `targetDurationSeconds`, sentence length, banned phrases, fact references all
   come from `thresholds.json`.

## Rules that bite silently

- **Changed `text` means run `bun run tts <id>` again.** Scene lengths and
  captions come from `voice.json`; a stale one drifts with no error on screen.
- **Scene length is never set by hand.** It comes from the real voice track.
- On-frame text must not repeat the line being spoken (§7); that is the caption's job.

## Verify

- [ ] `flow` and `visual` set; every fact id resolves
- [ ] `voice.json` newer than the last edit to `narration.json`
- [ ] whole track listened to, no loops, numbers pronounced right
- [ ] `bun run lint <id>` 0 errors, warnings read

Next: wording polish with `sk-style` if lint flags §3b, else `sk-scene`.

© howznguyen · MIT · howznguyen/shorts-kit

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

Каталог скиллов SKILL.md →
document-to-narration jwynia Скилл document-to-narration превращает статьи и Markdown-документы в озвученный видеоскрипт с разбивкой на сцены, файлом озвучки и точными таймкодами слов в VTT. CX Codex +1 1 000установок find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

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

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

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

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