sk-render
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.
howznguyen · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add howznguyen/shorts-kit --skill sk-render技能说明
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 ."
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 checkclean, stills reviewed (sk-scene).voice.jsonis newer thannarration.json; otherwise runbun run tts <id>first.
Steps
- Render:
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.bun run render <id> # → out/<id>/<id>.mp4 - Check the render is whole. Exit 0 is not proof. Duration should match
voice.jsonduration plusoutroHold:ffprobe -v error -show_entries format=duration -of default=nw=1 out/<id>/<id>.mp4 - Look at frames from the mp4 itself, not from the studio: the first frame,
a frame per scene, the last frame.
Open them. Delete theffmpeg -v error -ss <seconds> -i out/<id>/<id>.mp4 -frames:v 1 out/<id>/check-<seconds>.pngcheck-*.pngfiles when done. - Normalize loudness:
Then listen: music must stay below the voice by at leastbun run normalize <id> # → out/<id>/<id>-loud.mp4, target loudnessLUFS (default -13)musicUnderVoiceDb(§8), fade to zero, and the last 3 to 4 seconds hold the final frame. - Encode for upload:
Why this step exists: Remotion's default output can be full-rangebun run encode <id> # → out/<id>/<id>-upload.mp4yuvj420pwith an unusual sample rate and no faststart. Platforms re-encode assuming limited range, so colour comes out crushed or washed out, and nothing errors. - Verify the upload file:
Expectffprobe -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.mp4yuv420p,tv,bt709on all three colour axes,48000. - Re-measure loudness on the final file, because encoding touches audio:
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 amoovatom, still exiting 0. ffmpeg -ssbefore-iseeks to a keyframe; for sample-accurate audio checks use-af "atrim=start=A:end=B,volumedetect".volumedetectlogs at info level, so do not pass-v erroror the numbers vanish.- Keep every output inside
out/<id>/(§13). No loose files at the root ofout/. - Render order and file names stay stable: the hand-off reads exact paths.
Verify
-
out/<id>/<id>.mp4duration matches the voice + outro hold - frames pulled from the mp4 and opened
-
<id>-loud.mp4at target loudness, no clipping, music under the voice floor -
<id>-upload.mp4passes the ffprobe checks above
Next: sk-handoff (cover can be done before or after encode).