sugarforever/boring-video-studio · Archived

to-spec-beats

Use when turning a topic, article, research bundle, or existing draft into the content architecture for a narrated video.

First seen Aug 14, 2026

Installation

$ npx skills add sugarforever/boring-video-studio --skill to-spec-beats

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from sugarforever/boring-video-studio · top by installs.

npx skills add sugarforever/boring-video-studio

Browse all from sugarforever/boring-video-studio

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 83
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,814 B
  • docs SUMMARY.md 142 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 11 installs

SKILL.md

To spec beats

Turn source material into BEATS.md: the video's factual and narrative spine. This pass decides what the viewer learns and in what order; later passes decide wording and visuals.

Process

  1. Read every supplied source and existing fact-check. Resolve material factual uncertainty before treating a claim as a beat.
  2. Define the audience, prior knowledge, one-sentence thesis, desired change in understanding, target duration, and scope boundary.
  3. Build the reverse-iceberg arc: hook in viewer language, value or answer by beat two, then evidence, mechanism, implications, and close.
  4. Give every beat one cognitive job. Split beats that require two independent realizations; remove beats whose job does not trace to the thesis.
  5. Write BEATS.md beside the source material using this shape:
---
audience: ...
thesis: ...
viewer_shift: ... → ...
target_duration: ...
---

## B01 — Title
- job: What changes in the viewer's understanding
- claim: The factual statement this beat establishes
- evidence: Source or observation supporting it
- setup: Prior beat knowledge this depends on
- handoff: Question or tension passed forward
- duration: Rough narration budget

Notes needed to write this beat accurately.
  1. Audit the complete file: every claim has support, every dependency points backward, the thesis lands by beat two, and the duration budgets fit the target.

Beat IDs are stable interfaces. Preserve them through revisions and assign a new ID when inserting a beat.

BEATS.md is complete when another writer can draft the narration without inventing the argument, claims, order, or scope.