跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

sk-pipeline

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.

howznguyen · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add howznguyen/shorts-kit --skill sk-pipeline

技能说明


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 ."

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

#StepSkillRulesEvidence on disk before moving on
0If SOUL.md's change log has no entries, the rules were never adapted: offer first-run setupsk-improveSOUL.mdchange log has entries, or user declined
1Idea: one sentence the viewer can repeat after watchingsk-brief§1sentence written in the brief
2Facts: every claim sourced and recordedsk-facts§9bun run facts clean
3Flow + visual choice, image licences checkedsk-brief§2, §5, docs/flows/, docs/visuals/bun run new <id> --flow <X> done
4Briefsk-brief§2, §5briefs/<id>.md with fact ids
5Narrationsk-narration (polish: sk-style)§1, §3, §3b, §3csrc/videos/<id>/narration.json
6TTSsk-narration§4voice.json + public/audio/<id>/voice.mp3, listened to
7Lintsk-narrationdocs/soul/thresholds.jsonbun run lint <id> 0 errors, warnings read
7bStoryboard: one row per camera shot, approved by the user before any scene codesk-scene§12, docs/storyboard.mdbun run storyboard <id> clean, shots approved
8Scenes (+ optional SFX, docs/sfx.md)sk-scene§5, §6, §7, §8, §12, §13bun run check clean
9Still reviewsk-scene§7stills in out/<id>/ opened and looked at
10Rendersk-render§11out/<id>/<id>.mp4, frames checked
11Coversk-handoff§10out/<id>/<id>-cover.png checked at 200 px
12Normalizesk-render§8out/<id>/<id>-loud.mp4, loudness measured
13Encodesk-render§11out/<id>/<id>-upload.mp4, ffprobe checked
14Hand-offsk-handoff§10, §11caption, 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:

#StepCommandEvidence
3Flow + visual: talking-head shows the take; any other visual uses only its audiobun run new <id> --flow <X> --visual talking-head or --visual <type> --voice recordednarration.json voice.engine recorded
5aIngest: normalise, Whisper transcript, proposed cutsbun run ingest <id> <file> --lang <code> [--prompt "names"]transcript.json, review read, every ⟪words missing?⟫ heard
5bCut: edit cuts.json (reasons), fix misheard words with spelling, never retype a linebun run cut <id>footage.json, voice.mp3 listened to end to end
2Facts, AFTER the transcript: every claim said is verified, cut, or "claim": falsesk-factslint 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
阅读完整来源 ↗