sk-render — скилл для Claude Code: рендер и установка
Скилл sk-render для Claude Code рендерит короткие видео в MP4, нормализует громкость и готовит файл к загрузке. Запускается по просьбам отрендерить ролик, исправить тихий звук или проверить повреждённый файл.
MIT ★ 204 обновлён 2026-11-09
npx skills add howznguyen/shorts-kit --skill sk-render -a claude-codeЧто делает sk-render
Скилл собирает видео через Remotion, нормализует звук и перекодирует MP4 под параметры загрузки: yuv420p, ограниченный цветовой диапазон, метки BT.709 и аудио 48 kHz. Затем проверяет длительность и потоки через ffprobe, а кадры извлекает из готового файла для визуальной проверки.
Перед рендером нужны чистые результаты bun run lint <id> и bun run check, проверенные кадры, а voice.json должен быть новее narration.json. Используются bun, ffmpeg и ffprobe; если голосовой файл устарел, сначала запускается bun run tts <id>. Итоговые файлы остаются в out/<id>/, а после кодирования громкость измеряется повторно, поскольку кодирование затрагивает аудио.
Какие задачи решает
- отрендерить короткое видео в MP4
- нормализовать громкость голоса и музыки
- перекодировать ролик под параметры загрузки
- проверить длительность, цветовые метки и аудиопоток
Примеры запросов агенту
- Отрендери короткое видео с идентификатором
demoи проверь итоговый MP4. - Увеличь громкость ролика
demo, затем подготовь файл для загрузки. - Проверь, почему итоговый файл
demoобрезан или некорректно воспроизводится.
Как установить sk-render
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-render -a claude-code2Вручную: положить файлы
~/.claude/skills/sk-render/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sk-render/
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-render -a codex2Вручную: положить файлы
.agents/skills/sk-render/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-render -a cursor2Вручную: положить файлы
.cursor/skills/sk-render/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install howznguyen/shorts-kit .claude/skills/sk-render2Вручную: положить файлы
.github/skills/sk-render/SKILL.md1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-render -a gemini-cli2Командой платформы
gemini skills install https://github.com/howznguyen/shorts-kit --path .claude/skills/sk-renderВручную: положить файлы
.devin/skills/sk-render/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sk-render
Как установить sk-render в Claude Code?
Выполни npx skills add howznguyen/shorts-kit --skill sk-render -a claude-code. Файл скилла находится по пути ~/.claude/skills/sk-render/SKILL.md.
Что делает sk-render?
Рендерит видео через Remotion, нормализует громкость и готовит MP4 к загрузке. Также проверяет длительность, кадры, параметры видео и аудио.
Что нужно для работы sk-render?
Нужны bun, ffmpeg и ffprobe, а также актуальные voice.json и narration.json. Перед рендером должны пройти bun run lint <id> и bun run check.
Исходный текст
SKILL.md · MIT
---
name: sk-render
description: Renders a short to mp4 with Remotion, normalises loudness, and re-encodes it to the platform upload spec (yuv420p limited range, BT.709 tags, 48 kHz audio, faststart), then verifies each file with ffprobe and by looking at frames. Use when the user says "render the video", "export it", "make the final mp4", "fix the loudness", "it's too quiet", "colours look washed out after upload", "the file won't play", or reports a truncated or broken output. Steps 10, 12 and 13 of sk-pipeline.
---
# sk-render: render, normalize, encode
**Announce:** "Using sk-render for <id>."
Rules: §8 audio (`docs/soul/06-audio.md`), §11 encode spec
(`docs/soul/08-cover-and-handoff.md`), §13 files. The § wins over this file.
## Before rendering
- `bun run lint <id>` 0 errors, `bun run check` clean, stills reviewed (`sk-scene`).
- `voice.json` is newer than `narration.json`; otherwise run `bun run tts <id>` first.
## Steps
1. **Render:**
```bash
bun run render <id> # → out/<id>/<id>.mp4
```
Remotion bundles the source when the render starts. Editing files during a
render changes nothing in that render; if a fix is missing from the output,
compare the file's modification time with the render start before debugging code.
2. **Check the render is whole.** Exit 0 is not proof. Duration should match
`voice.json` duration plus `outroHold`:
```bash
ffprobe -v error -show_entries format=duration -of default=nw=1 out/<id>/<id>.mp4
```
3. **Look at frames from the mp4 itself**, not from the studio: the first frame,
a frame per scene, the last frame.
```bash
ffmpeg -v error -ss <seconds> -i out/<id>/<id>.mp4 -frames:v 1 out/<id>/check-<seconds>.png
```
Open them. Delete the `check-*.png` files when done.
4. **Normalize loudness:**
```bash
bun run normalize <id> # → out/<id>/<id>-loud.mp4, target loudnessLUFS (default -13)
```
Then listen: music must stay below the voice by at least `musicUnderVoiceDb`
(§8), fade to zero, and the last 3 to 4 seconds hold the final frame.
5. **Encode for upload:**
```bash
bun run encode <id> # → out/<id>/<id>-upload.mp4
```
Why this step exists: Remotion's default output can be full-range `yuvj420p`
with an unusual sample rate and no faststart. Platforms re-encode assuming
limited range, so colour comes out crushed or washed out, and nothing errors.
6. **Verify the upload file:**
```bash
ffprobe -v error -select_streams v:0 \
-show_entries stream=pix_fmt,color_range,color_primaries,color_transfer,color_space \
-of default=nw=1 out/<id>/<id>-upload.mp4
ffprobe -v error -select_streams a:0 -show_entries stream=sample_rate \
-of default=nw=1 out/<id>/<id>-upload.mp4
```
Expect `yuv420p`, `tv`, `bt709` on all three colour axes, `48000`.
7. **Re-measure loudness on the final file**, because encoding touches audio:
```bash
ffmpeg -i out/<id>/<id>-upload.mp4 -af ebur128 -f null - 2>&1 | grep -A3 Summary
```
## Traps
- **Never pipe a long ffmpeg command into `head`.** ffmpeg gets SIGPIPE and leaves
an mp4 without a `moov` atom, still exiting 0.
- `ffmpeg -ss` *before* `-i` seeks to a keyframe; for sample-accurate audio checks
use `-af "atrim=start=A:end=B,volumedetect"`. `volumedetect` logs at info level,
so do not pass `-v error` or the numbers vanish.
- Keep every output inside `out/<id>/` (§13). No loose files at the root of `out/`.
- Render order and file names stay stable: the hand-off reads exact paths.
## Verify
- [ ] `out/<id>/<id>.mp4` duration matches the voice + outro hold
- [ ] frames pulled from the mp4 and opened
- [ ] `<id>-loud.mp4` at target loudness, no clipping, music under the voice floor
- [ ] `<id>-upload.mp4` passes the ffprobe checks above
Next: `sk-handoff` (cover can be done before or after encode).
© howznguyen · MIT · howznguyen/shorts-kit