Srt Whiteboard Animation

What it does

When your agent uses it

• Tasks that involve Transcription

Example prompts

• “字幕做成白板手绘/流式笔迹视频”
• “SRT 生成白板动画”
• “按字幕分镜画手绘”
• “/srt-whiteboard-animation”

Requirements

• Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1读字幕、出策略（不生成图片）。 用 scripts/parse_srt.py 把 SRT 解析成字幕条并按 25–35 秒/幕给出建议分镜。据此输出配图策略：每幕的场景编号、核心表达、画面主体、对应字幕区间与…
2. 2生成线稿。 仅在用户确认策略后，按“统一出图视觉规范”逐幕生成 16:9 暖米黄旧纸张底线稿图，背景 #F5EBD7，主体之间保留充足留白便于自动拆分；不得生成文字、复杂照片、重叠对象或与规范冲突的元素。完成后停止，展示线稿并等待用户确认。
3. 3先读字幕再看图，然后标注并打开预览台。 仅在用户确认线稿后，先阅读该图对应的字幕、再实际查看图片、并获取原图像素宽高；不得只凭字幕臆测画面，也不得只按画面位置机械排序。先提炼字幕叙事事件，再把图中可见主体对应到事件，按“场景铺垫 → 关键人物/物体 → 动作冲突或变化 →…
4. 4生成区域预览图。 仅在用户确认标注与预览内容后，用 render_annotation_preview.py 出编号/方向检查图，核对分区与叙事顺序一致、区域都在画布内、重叠主体用 protectedRegions 保护。完成后停止，等待用户确认预览图。
5. 5在预览台调整并保存。 仅在用户确认预览图后，在已打开且已载入对应目录的预览台调整：默认（未播放）显示完整图片和区域框；画布是矩形代理：拖区域四边四角改 region，右侧改名称/方向/开始(ms)/结束(ms)（时长= 结束−开始，只读）与字幕，拖动模块列表调整顺序（自动重排…
6. 6命令行渲染成片。 仅在用户确认最终标注与时序后，用 render_stream_whiteboard.py 逐幕出全清 MP4，抽查开场、任意重叠模块中段、结尾三个时间点。完成后停止，等待用户确认成片。
7. 7多幕合并（仅适用于多幕）。 仅在用户确认所有单幕成片后，用 merge_scenes.py 按顺序合并成一条。完成后停止，等待用户确认最终合成视频。

What it can do on your machine

Read from SKILL.md and the folder at commit 696a724. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 4 files in scripts/ (Python, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • python

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Srt Whiteboard Animation loads about 1.8k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 303 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~66

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from geeklee/srt-whiteboard-animation at commit 696a724, republished under its MIT licence (© geeklee). 303 words, ~1,782 tokens.

name

srt-whiteboard-animation

description

将 SRT 字幕做成暖米黄纸张底的白板手绘动画：读字幕→输出配图策略→确认后生成统一风格线稿→按叙事语义标注分区→预览台调整→渲染 MP4。编排沿用分区遮罩揭示（annotation.json / sequence / startMs / protectedRegions），但每个区域内的落墨换成 stream 的连续笔迹（骨架/网格 ink→color）。当用户提供 SRT 字幕并要求"字幕做成白板手绘/流式笔迹视频""SRT 生成白板动画""按字幕分镜画手绘"时触发。

assets/whiteboard/<项目名>/
  scene-01-<名称>.png
  scene-01-<名称>.annotation.json     # 与 png 同名
  scene-01-<名称>-whiteboard.mp4      # 成片
  scene-01-<名称>-preview.mp4         # 真实片段（预览台生成，低清）

{
  "sceneId": "scene-01",
  "canvas": { "width": 1672, "height": 941 },
  "storyBasis": "该幕字幕的事件摘要",
  "sceneDurationMs": 9000,
  "elements": [
    {
      "id": "rockery",
      "label": "假山场景",
      "sequence": 1,
      "narrativeRole": "故事的场景铺垫",
      "subtitle": "猴子山上，一只小猴子坐在假山顶端，手里拿着香蕉。",
      "type": "structure",
      "region": { "x": 20, "y": 120, "width": 540, "height": 780 },
      "reveal": { "direction": "top_to_bottom", "startMs": 300, "durationMs": 2600, "maskPaddingPx": 22, "protectedRegions": [] },
      "handPath": { "start": [290, 130], "end": [290, 890], "easing": "easeInOut" }
    }
  ]
}

© geeklee, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 18 other files (scripts, assets) in the repository root of geeklee/srt-whiteboard-animation.

• SKILL.md
• .gitignore
• LICENSE
• README.md
• agents/openai.yaml
• assets/drawing-hand.png
• assets/preview.html
• examples/scene-01-monkey-mountain-banana-whiteboard.gif
• examples/scene-01-monkey-mountain-banana-whiteboard.mp4
• examples/scene-01-monkey-mountain-banana.annotation.json
• examples/scene-01-monkey-mountain-banana.png
• examples/scene-01-monkey-mountain-stream.gif
• examples/scene-01-monkey-mountain.png
• scripts/merge_scenes.py
• scripts/parse_srt.py
• scripts/prepare_env.py
• scripts/render_annotation_preview.py
• … and 2 more

Open the folder on GitHubat commit 696a724