To Spec Beats

Use when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

192 stars 28 forksImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sugarforever/boring-video-studio --skill to-spec-beats
Manual install
git clone --depth 1 https://github.com/sugarforever/boring-video-studio.git /tmp/boring-video-studio
mkdir -p ~/.claude/skills
cp -r /tmp/boring-video-studio/skills/boring-video/to-spec-beats ~/.claude/skills/to-spec-beats

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# To spec beats

Turn an approved `content/ARTICLE.md` into `BEATS.md`: the video's factual and narrative spine. The article owns what the work says; this pass decides what the viewer learns when. Later passes decide spoken wording and visuals.

## Process

1. Read `content/ARTICLE.md`, `content/TOPIC.md` when it exists, and the evidence needed to preserve their boundaries. Recompute each approved file's SHA-256 after removing only its `approved_digest:` line; continue only when the stored digest matches the current file and the article has `status: approved`. When a user brings a complete article from outside this workflow, first place or adapt it as `content/ARTICLE.md` using the external-source contract from `/boring-video`; a separate topic contract is not required retroactively.
2. Inherit the audience, thesis, and scope from the approved article and topic contract when present. Define only the audience's prior knowledge, desired change in understanding, target duration, and the video's selection from the approved scope.
3. Build the reverse-iceberg arc: hook in viewer language, value or answer by beat two, then evidence, mechanism, implications, and close. Reorder, compress, or omit article material for the medium while preserving meaning and boundaries.
4. Give every beat one cognitive job. Split beats that require two independent realizations; remove beats whose job does not trace to the approved thesis.
Read the full skill on GitHub

Details

Skill name
to-spec-beats
Path
skills/boring-video/to-spec-beats/SKILL.md
License
MIT
Repo updated
9 November 2026

FAQ

What does the To Spec Beats skill do?

Use when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

How do I install the To Spec Beats skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sugarforever/boring-video-studio --skill to-spec-beats. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is To Spec Beats popular?

It lives in sugarforever/boring-video-studio, which has 192 GitHub stars and 28 forks.

Related skills

Boring Video

192

sugarforever/boring-video-studio

Use when developing a content-driven video from a topic, research bundle, article, or draft, or when routing an existing script or non-argument video into HyperFrames production.

Images, Video & Audio28

Develop Topic

192

sugarforever/boring-video-studio

Use when a content-driven video has a candidate topic but still needs research, experiments, a defensible thesis, or user-approved scope before an article or video beats can be written.

Software Development28

Record Terminal

192

sugarforever/boring-video-studio

Use when a video must show terminal commands, CLI output, streamed execution, full-screen terminal applications, or code entered inside a terminal session.

Images, Video & Audio28

To Video

192

sugarforever/boring-video-studio

Use when continuing approved video plans into HyperFrames production, or revising and reviewing an existing video, with optional ListenHub narration.

Images, Video & Audio28

To Scenes

192

sugarforever/boring-video-studio

Use when a narrated video's beats and draft narration need visual direction, scene concepts, metaphors, worlds, action, camera logic, or visual continuity before storyboarding.

Images, Video & Audio28

Verysmallwoods Video

192

sugarforever/boring-video-studio

小木头的个人视频流水线。基于一个主题,一篇文章,或一份口播稿,生成一整套可发布物料:视频成片,封面图,YouTube/Bilibili 文案,博客,以及社交媒体推广文案。视频制作采用 HyperFrames。

Images, Video & Audio28

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.