Works with
Packaged from the source skill for Claude, Codex and 4 more.
About this skill
Video Beat Board checks whether a short video script fits its intended duration. You supply a brief and beat list in JSON, including narration, on-screen text and visual notes. Its single Python utility estimates the time each beat needs and writes scene data or reports that the draft does not fit.
Use this skill when
- A draft has more narration or on-screen text than the target length can reasonably accommodate.
- You want a timed scene outline before producing a visual animatic.
- A data or end-card beat needs enough room to register rather than being squeezed between other shots.
What it can do
The tool uses fixed reading and narration assumptions, minimum shot durations and extra time for selected data beats. It distributes spare time across the cut and marks candidate footage upgrades according to the supplied lane. The source includes a sample brief, and hand-written brief JSON is supported without importing another skill.
The timing model does not listen to a recorded voice or measure a viewer’s comprehension. Review its assumptions for language, performance and audience, and check actual playback afterward. The separate Video Director workflow can normalize a brief, and Video Animatic can render the resulting scene; neither is bundled here. This standalone package produces timing and scene JSON, not a finished video or footage.
Typical workflows
- Prepare the inputs: record the target duration and aspect in a brief, then describe each beat’s narration, text and visual intent.
- Check fit: inspect the per-beat timing and any requested cuts; remove or rewrite material rather than silently extending an agreed duration.
- Hand off the scene: inspect the generated shot data and pass it to a compatible rendering workflow for visual and recorded-audio review.
What is inside the skill
Section headings from the original SKILL.md (about 319 words of instructions). Read the full text in the source repository before installing.
- Workflow
- Rules of thumb the tool encodes
- Forcing questions
Bundled files
references/beat_timing.mdscripts/beat_board.pyLICENSE
Example prompts
- Check these hand-written brief and beat JSON files for a 15-second release teaser. Show which beats need the most time and recommend wording cuts without increasing the agreed duration.
- Prepare a timed scene outline from this narration and three factual chart beats. Preserve the verified numbers, give the end card room to register and write scene JSON without rendering footage.
- Review this beat list for a bilingual social video. Explain the fixed timing assumptions, identify where a real voice recording could change the estimate and list the checks needed in a later animatic.
How to install Video Beat Board
Claude Packaged
- Download the Claude package from the skill page. The ZIP contains one folder named after the skill, with SKILL.md and any bundled reference files.
- For Claude Code, unpack the folder into ~/.claude/skills/ to use it in every project, or into .claude/skills/ inside a repository to share it with your team.
- For Claude apps, upload the ZIP in the Skills section of the capabilities settings.
- Start a new session and describe the task in your own words. Claude picks the skill when the request matches its description.
Codex Packaged
- Download the Codex package. The ZIP contains one folder named after the skill, with SKILL.md and bundled resources.
- Unpack the complete folder into .agents/skills/ inside your repository, or into ~/.agents/skills/ for personal use. Preserve its relative reference-file paths.
- Start a new Codex session and invoke the skill by name or with $skill-name, or describe a matching task.
- AGENTS.md is separate project guidance. The ZIP does not generate or modify that file.
GPT Packaged
- Download the GPT package from the skill page.
- Create or edit a custom GPT (or a ChatGPT project) and paste the contents of SKILL.md into the instructions field.
- Upload the bundled reference files as knowledge so the GPT can consult them.
- Test with one of the example prompts from the skill page and adjust the instructions if your use case differs.
Gemini Packaged
- Download the Gemini package from the skill page.
- For a project, unpack the complete folder into .gemini/skills/ or .agents/skills/. For personal use, use ~/.gemini/skills/ or ~/.agents/skills/.
- Run /skills reload in Gemini CLI, then /skills list to check discovery. There is no need to paste the skill into GEMINI.md.
- Test a matching task and verify the referenced tools and files are available.
Cursor Packaged
- Download the Cursor package from the skill page.
- Unpack the complete skill folder into .cursor/skills/ or .agents/skills/ in your project. For personal local use, ~/.cursor/skills/ and ~/.agents/skills/ are also supported.
- Start a new Cursor session. Type / in Agent chat and select the skill name, or describe a matching task.
- Commit the skill folder and resources for team use. Personal local skills are not automatically available to remote agents or automation runs.
OpenCode Packaged
- Download the OpenCode package from the skill page.
- Unpack the complete folder into .opencode/skills/ in your project, or ~/.config/opencode/skills/ for personal use. OpenCode also supports .agents/skills/ and .claude/skills/ compatibility locations.
- Keep supporting files at their original relative paths. AGENTS.md is separate project-wide guidance and is not generated by this ZIP.
- Start OpenCode in the project and test a matching task with the model and permissions you use.
Permissions & security
Inspect the source, license and declared permissions before use. Read the scripts before running them. Review method
Video Beat Board FAQ
What does the Video Beat Board skill do?
Time a supplied video beat list against a brief and emit a scene JSON when it fits. Uses local arithmetic and can accept hand-written inputs; rendering and the full director pipeline are separate.
Which AI agents can use Video Beat Board?
Packages for Claude, Codex and 4 more are built from the same source instructions.
How do I install Video Beat Board in Claude?
Download the Claude package from the skill page. The ZIP contains one folder named after the skill, with SKILL.md and any bundled reference files. For Claude Code, unpack the folder into ~/.claude/skills/ to use it in every project, or into .claude/skills/ inside a repository to share it with your team.
Who made Video Beat Board and what is the license?
Video Beat Board is published by Alireza Rezvani under the MIT license. The source is https://github.com/alirezarezvani/claude-skills/tree/main/video/skills/video-beat-board. The catalog keeps the original attribution.
What permissions does Video Beat Board need?
Declared permissions: read project files, write generated skill files. Risk level: low. Check the scripts in the source before running them.