菜单
Code-based video create, edit, render, preview, and validate. Defaults to Remotion for JSON/React timelines, routes HyperFrames HTML video, TTS/STT captions, FFmpeg transforms, existing-footage editing, and docs-first provider/video-understanding workflows.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | video |
| description | Code-based video create, edit, render, preview, and validate. Defaults to Remotion for JSON/React timelines, routes HyperFrames HTML video, TTS/STT captions, FFmpeg transforms, existing-footage editing, and docs-first provider/video-understanding workflows. |
Route video work before rendering. Remotion is the implemented default for JSON/React timeline videos. HyperFrames is the HTML/CSS/GSAP route for agent-authored compositions. FFmpeg handles deterministic media transforms.
Triggers: "video", "Remotion", "HyperFrames", "animation", "mp4", "render video", "slides to video", "HTML video", "edit this video", "subtitle video", "video summary", "image to video", "presenter video".
Core rule: choose the route, load the matching reference, produce route-specific artifacts, and validate the output. A successful command is not enough.
Authoring discipline: keep the main skill short, move deep engine rules into references, and avoid copying large third-party docs into the active prompt.
Read reference/route-selector.md when intent is not a simple Remotion render.
| User intent | Route | Status | Read |
|---|---|---|---|
| React/JSON timeline, branded explainer, TTS, captions, slide-to-video | Remotion | Active default | reference/remotion.md |
| HTML/CSS/GSAP composition, kinetic typography, premium tech briefing | HyperFrames | Active smoke route | reference/hyperframes.md |
| Authored narration, script-first subtitles, TTS-ready caption sidecars | TTS captions | Active via script JSON + Remotion draft timeline | reference/tts-captions.md |
| Audio/video transcription, diarized captions, subtitle generation, word-timed captions | STT captions | Active via progrok HTTP STT + FFmpeg prep | reference/stt-captions.md |
| Trim, concat, transcode, proxy, audio, reframe, deterministic media ops | FFmpeg utility | Active utility | reference/validation.md |
| Cut/polish existing footage with transcript, EDL, subtitles, overlays | Existing-footage editing | Docs-first | reference/existing-footage-editing.md |
| New generative video clips, image-to-video, cinematic model output | Provider video generation | Deferred docs-first | reference/route-selector.md |
| Presenter/avatar/talking-head video | Presenter/avatar video | Deferred docs-first | reference/route-selector.md |
| Search, summarize, index, or clip moments from existing video | Video understanding | Deferred docs-first | reference/route-selector.md |
| Browser-native media capture or MediaRecorder-style render | Browser media | Watchlist | reference/route-selector.md |
Default choice:
Do not promise render support for docs-first or watchlist routes. State the missing harness or provider requirement.
For any non-trivial original video, read:
reference/visual-direction.mdreference/style-packs.mdreference/visual-quality.mdWorkflow:
Hard rule: style presets are direction; validation gates are law.
Use Remotion for the implemented JSON timeline pipeline.
node skills_ref/video/scripts/pipeline.mjs \
--timeline timeline.json \
--output /tmp/remotion-render
Common commands:
| Task | Command |
|---|---|
| Render | node scripts/pipeline.mjs --timeline <path> [--preset Landscape-1080p] |
| Render with TTS | node scripts/pipeline.mjs --timeline timeline.draft.json |
| Skip TTS | node scripts/pipeline.mjs --timeline timeline.draft.json --skip-tts |
| TTS only | node scripts/tts.mjs --batch timeline.draft.json [--provider progrok] |
| TTS single | node scripts/tts.mjs --text "안녕하세요" --output /tmp/tts.mp3 --provider progrok --language ko |
| TTS voices | curl http://127.0.0.1:18645/v1/tts/voices |
| TTS captions | node scripts/tts-captions.mjs --script script.json --output /tmp/video-tts-captions |
| STT captions | node scripts/stt-captions.mjs --input input.mp4 --output /tmp/video-stt --language ko --diarize --word-timestamps |
| Preview | cd remotion-project && pnpm exec remotion studio |
| Validate | node scripts/validate-artifact.mjs /tmp/remotion-render/TimelineVideo.mp4 --preset Landscape-1080p |
Read reference/remotion.md for timeline authoring, presets, TTS, components,
animation rules, and validation details.
Remotion animation rules:
useCurrentFrame, interpolate, spring, and <Sequence>.skills_ref/video.Use HyperFrames when the deliverable should be authored as HTML/CSS/GSAP.
npx --yes hyperframes doctor
npx --yes hyperframes init /tmp/my-video --example blank --non-interactive --skip-skills --resolution landscape
npx --yes hyperframes lint /tmp/my-video
npx --yes hyperframes render /tmp/my-video --output /tmp/my-video/renders/out.mp4 --format mp4 --quality standard --fps 30
ffprobe -v error -show_format -show_streams -of json /tmp/my-video/renders/out.mp4
Before rendering, author the composition. Rendering an untouched blank scaffold is not valid proof.
Read reference/hyperframes.md for production loop, premium tech briefing
style, GeekNews smoke recipe, and verification gates.
FFmpeg is the active deterministic media utility route.
Examples:
# Extract segment
ffmpeg -i raw.mp4 -ss 00:12:30 -to 00:15:45 -c copy segment_01.mp4
# Concatenate listed files
ffmpeg -f concat -safe 0 -i concat.txt -c copy assembled.mp4
# Proxy for faster editing
ffmpeg -i raw.mp4 -vf "scale=960:-2" -c:v libx264 -preset ultrafast -crf 28 proxy.mp4
# Extract audio for transcription
ffmpeg -i raw.mp4 -vn -acodec pcm_s16le -ar 16000 audio.wav
# Normalize audio
ffmpeg -i segment.mp4 -af loudnorm=I=-16:TP=-1.5:LRA=11 -c:v copy normalized.mp4
For cut-heavy editing, subtitles, transcript-aware decisions, or output
timeline EDLs, read reference/existing-footage-editing.md instead of treating
the task as raw FFmpeg snippets.
Read reference/validation.md before declaring a video task complete.
Minimum route evidence:
| Route | Evidence |
|---|---|
| Remotion | output path, non-zero MP4, validate-artifact.mjs or ffprobe, sampled/still frame for non-trivial visuals |
| HyperFrames | doctor/lint/render, ffprobe, sampled frames or inspect output, visual QA verdict |
| TTS captions | script JSON, normalized narration, captions.remotion.json, draft/final timeline, TTS manifest or skip-TTS rationale, non-silent audio proof when TTS is expected, alignment proof when TTS changes duration, rendered frame proof if overlaid |
| STT captions | raw transcript, normalized transcript, SRT/VTT, captions.remotion.json, timestamp checks, rendered frame proof if overlaid |
| FFmpeg | input/output ffprobe, expected duration/dimensions/codec, output inspection |
| Existing footage | EDL/timeline artifact, transcript cache when speech matters, subtitle-last proof, cut-boundary checks |
Command succeeded != done. Completion requires route-specific evidence.
Read reference/workspace-policy.md for source/output boundaries.
skills_ref/video is source, not workspace./tmp or a project output folder.| File | When to read |
|---|---|
reference/route-selector.md | ambiguous intent, docs-first routes, provider/understanding/presenter requests |
reference/remotion.md | Remotion timeline, TTS, components, animation, render pipeline |
reference/hyperframes.md | HTML/CSS/GSAP compositions and premium tech briefings |
reference/tts-captions.md | authored narration, script-first subtitles, TTS-ready caption sidecars |
reference/stt-captions.md | audio transcription, diarization, subtitles, word-level timing, Remotion caption JSON |
reference/existing-footage-editing.md | transcript/EDL/subtitle/cut-boundary editing |
reference/visual-direction.md | design read before non-trivial original video |
reference/style-packs.md | first-pass video aesthetics and banned cliches |
reference/visual-quality.md | anti-slop frame, typography, layout, and motion rules |
reference/validation.md | proof bundles and completion gates |
reference/workspace-policy.md | generated media, reference repos, and commit policy |
reference/tts-integration.md | provider auth, voiceControl, speed, caching |
reference/components.md | Remotion component library details |
~/.jaw-shared/remotion/node_modules/node scripts/ensure-remotion.mjsnpx --yes hyperframes .../v1/tts by default; run progrok proxy
or use PROGROK_BASE_URL when the proxy is on another port.captionText to display English proper nouns
while narration stays provider-friendly. Captions auto-wrap with newline
breaks and default to a smaller lower-third size.progrok proxy /v1/stt, plus ffmpeg/ffprobeGEMINI_API_KEY for Gemini, SUPERTONE_API_KEY for Supertone,
none for SupertonicMUST USE for cli-jaw PABCD orchestration workflows — orchestrate, phase, attest/attestation, interview mode, goal mode, checkpoints, and multi-phase development. Triggers: orchestrate, phase, attest, attestation, interview, goal mode, checkpoint, PABCD, 요구사항 정리, 인터뷰, 스펙 정리. Operate state transitions only when the user explicitly requests orchestration or an active PABCD phase is injected — do not transition state merely because a document mentions phases, goals, or checkpoints.
MUST USE for every coding task — classifies work depth (C0-C5), task_tags overlays, modular limits, pre-write search, verification-before-completion, and safety rules. Triggers: develop, implement, refactor, feature, bug fix, test, review, code quality, scaffolding.
Use only on the Codex CLI for native image generation or image editing without an API key. Save final PNG files under ~/.cli-jaw/uploads, report web-ready absolute-path markdown, and send to Telegram or Discord only when explicitly requested.
MUST USE for any real runtime debugging in any language — crashes, silent failures, wrong output, build/test failures, flaky tests, performance regressions, and integration bugs. A 5-phase root-cause method: architecture check → investigate → analyze → hypothesize → implement. Triggers: debug this, why is X failing, flaky test, fix the crash, root cause, error, stack trace, regression, 왜 안 돼, 디버깅, 원인 분석.
MUST USE for code review and review-readiness — review process, quality thresholds, antipattern detection, review verdicts, and giving/receiving feedback. Triggers: review this, code review, PR review, check my diff, before merge, antipattern, review-readiness, 리뷰, 코드 리뷰, 머지 전에 확인.
MUST USE for any frontend, web UI, or visual implementation work — building, styling, or redesigning pages/components, responsive layouts, motion, component architecture, and production-surface polish. Triggers: frontend, UI, component, CSS, responsive, animation, React, Vue, Svelte, Tailwind, layout, styling, redesign, mockup, anti-slop, 프론트엔드, UI 작업, 반응형, 디자인 수정.