Agent skill

To Spec Beats

by sugarforever in sugarforever/boring-video-studio

A skill your agent uses when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

MITAuto-check passedMedia & Creative

Install To Spec Beats

skills CLI
$ npx skills add sugarforever/boring-video-studio --skill to-spec-beats -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sugarforever/boring-video-studio to-spec-beats --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sugarforever/boring-video-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/boring-video/to-spec-beats .claude/skills/to-spec-beats && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
to-spec-beats
GitHub stars
168
Token cost
~977 tokens
SKILL.md length
453 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

  • Works in 5 steps: Read content/ARTICLE.md,… → Inherit the audience, thesis, and scope… → Build the reverse-iceberg arc: hook in… → …
  • An approved content article needs to be reorganized into the factual and narrative architecture for a narrated video
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

To Spec Beats is an agent skill from sugarforever/boring-video-studio. Use when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative. The repository describes itself as: 小木头的个人视频流水线 Agent Skill - VerySmallWoods Video. The licence is MIT.

When your agent uses it

  • An approved content article needs to be reorganized into the factual and narrative architecture for a narrated video

Example prompts

  • “/to-spec-beats”

Workflow steps

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

  1. Read content/ARTICLE.md, content/TOPIC.md when it exists, and the evidence needed to preserve their boundaries. Recompute each approved…
  2. Inherit the audience, thesis, and scope from the approved article and topic contract when present. Define only the audience's prior…
  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…
  5. Write BEATS.md beside content/ using this shape

What it can do on your machine

Read from SKILL.md and the folder at commit f3445d6. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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

To Spec Beats loads about 977 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 453 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~977

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from sugarforever/boring-video-studio at commit f3445d6, republished under its MIT licence (© sugarforever). 453 words, ~977 tokens.

Download SKILL.mdSave it as .claude/skills/to-spec-beats/SKILL.md (or your agent's skills folder).
name
to-spec-beats
description
Use when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

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.
    • Keep visual treatments, camera moves, animation, composition, and scene elements out of beats. Record only content facts needed by later stages. A visual idea discovered here moves to SCENES.md; it does not become part of the beat contract.
  5. Write BEATS.md beside content/ using this shape:
markdown
---
source: content/ARTICLE.md
source_digest: sha256:<ARTICLE approved_digest>
artifact_digest: sha256:<digest>
audience: ...
thesis: ...
viewer_shift: ... → ...
target_duration: ...
---

## B01 — Title
- job: What changes in the viewer's understanding
- claim: The factual statement this beat establishes
- source: Article heading or passage that establishes it
- evidence: Source or experiment already selected by the article
- setup: Prior beat knowledge this depends on
- handoff: Question or tension passed forward
- duration: Rough narration budget

Notes needed to write this beat accurately.

Compute artifact_digest as SHA-256 of the complete beats file after removing only the artifact_digest: line. Any later stage must recompute it rather than trust the stored value.

Show full SKILL.md (172 more words)Show less
  1. Audit the complete file: every material claim and viewpoint traces to the approved article, every dependency points backward, the thesis lands by beat two, and the duration budgets fit the target.

When the video structure exposes a missing fact, viewpoint, argument step, or conclusion, return it to content/ARTICLE.md. If resolving it changes a locked topic decision, return content/TOPIC.md to draft as well. Renew the required approvals, then propagate the change forward. Do not patch a content gap inside BEATS.md.

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

REQUIRED SUB-SKILL: Use artifact-preview for BEATS.md before declaring it complete and after every later source change. Present this as a content-structure review: it can approve the learning arc, claims, evidence, and duration budget, but never visual execution.

BEATS.md is complete when another writer can draft the narration without inventing content, every beat is a medium-specific arrangement of the approved article rather than a new argument, and the artifact-preview completion criterion is satisfied for BEATS.preview.html.

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

Files

Just SKILL.md in skills/boring-video/to-spec-beats of sugarforever/boring-video-studio.

Open the folder on GitHubat commit f3445d6

Compare with similar skills

To Spec Beats next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

To Spec Beats compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
To Spec Beats this skillsugarforever/boring-video-studio168—~977Automated safety check: PassMIT
Guizang Social Cardsop7418/guizang-social-card-skill7.4k1 repos~7.8kAutomated safety check: PassAGPL-3.0
Weekly Changelog Videoheygen-com/hyperframes60k—~3.3kAutomated safety check: PassApache-2.0
Anthropic Brand Stylinganthropics/skills180k30 repos~559Automated safety check: PassApache-2.0
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo130k—~2.1kAutomated safety check: WarnMIT
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Guizang Social Cards

    op7418/guizang-social-card-skill

    Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.

    7.4k GitHub starsUsed in 1 repo~7.8k tokens
    Media & CreativeAuto-check passed
  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    60k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Anthropic Brand Styling

    anthropics/skills

    Official

    Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.

    180k GitHub starsUsed in 30 repos~559 tokens
    Media & CreativeAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    130k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check: warnings
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Holo Card Studio

    EverettFish/holo-card-studio

    Create collectible holographic foil cards and two-image lenticular flip cards with AI-generated full-color ukiyo-e and colored sumi-e anime artwork, layered Blender scenes, renders, GLB export, and…

    1.9k GitHub stars~1.4k tokensUpdated 19 days ago
    Media & CreativeAuto-check passed

More from sugarforever/boring-video-studio

All 12 skills in this repo
  • Boring Video

    sugarforever/boring-video-studio

    A skill your agent uses 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.

    168 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Develop Topic

    sugarforever/boring-video-studio

    A skill your agent uses 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…

    168 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Setup Boring Video Skills

    sugarforever/boring-video-studio

    A skill your agent uses when installing, validating, or repairing the Boring Video planning skill set before its first use.

    168 GitHub stars~449 tokensUpdated yesterday
    Auto-check passed
  • To Article

    sugarforever/boring-video-studio

    A skill your agent uses when an approved content topic, research bundle, and evidence need to become a complete platform-independent article before video beats or publication adaptation.

    168 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Artifact Preview

    sugarforever/boring-video-studio

    A skill your agent uses when an artifact-owning skill requires a durable Markdown file to be presented for user review in a coding agent.

    168 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • To Narration

    sugarforever/boring-video-studio

    A skill your agent uses when writing or revising spoken narration from complete, lineage-valid video beats, including scripts that must remain open to later visual direction.

    168 GitHub stars~821 tokensUpdated yesterday
    Auto-check passed

Questions about To Spec Beats

What does To Spec Beats do?

A skill your agent uses when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video. To Spec Beats is an agent skill from sugarforever/boring-video-studio. Use when an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

When should I use To Spec Beats?

To Spec Beats fits situations like: an approved content article needs to be reorganized into the factual and narrative architecture for a narrated video.

How do I install To Spec Beats in Claude Code?

Run `npx skills add sugarforever/boring-video-studio --skill to-spec-beats -a claude-code`. Or copy the skill folder (skills/boring-video/to-spec-beats in sugarforever/boring-video-studio) into .claude/skills/to-spec-beats in your project. Claude Code loads it when a task matches its description.

How do I install To Spec Beats in Codex?

Run `npx skills add sugarforever/boring-video-studio --skill to-spec-beats -a codex`. Or copy the skill folder (skills/boring-video/to-spec-beats in sugarforever/boring-video-studio) into .agents/skills/to-spec-beats in your project. Codex loads it when a task matches its description.

Can I use To Spec Beats in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sugarforever/boring-video-studio --skill to-spec-beats -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/to-spec-beats, .gemini/skills/to-spec-beats, .github/skills/to-spec-beats and .opencode/skills/to-spec-beats in your project.

What does To Spec Beats need to run?

SKILL.md names no scripts, command-line tools or credentials: To Spec Beats is instructions for the agent only.

Does To Spec Beats access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is To Spec Beats safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does To Spec Beats use?

To Spec Beats is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does To Spec Beats use?

About 977 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to To Spec Beats?

Skills that share tags, products or a category with To Spec Beats: Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars), Weekly Changelog Video (heygen-com/hyperframes, 60k stars), Anthropic Brand Styling (anthropics/skills, 180k stars) and MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 130k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains To Spec Beats?

sugarforever (a GitHub user) maintains it in sugarforever/boring-video-studio, which has 168 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: sugarforever/boring-video-studio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.