HyperFrames Animation
heygen-com/hyperframes
Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.
Lock a picture edit to a music edit: scene boundaries on downbeats and drops, plus irregular camera-punch hits from bass re-entries and vocal hooks (<stemhits.json, schema music-hits/1) with a…
Install Beat Sync Video
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install BlackBeltTechnology/pi-agent-dashboard beat-sync-video --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/music-production/.pi/skills/beat-sync-video .claude/skills/beat-sync-video && rm -rf skills-srcUse ~/.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/
Install the "beat-sync-video" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-video into .claude/skills/beat-sync-video/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "beat-sync-video", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-videoType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install BlackBeltTechnology/pi-agent-dashboard beat-sync-video --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/music-production/.pi/skills/beat-sync-video .agents/skills/beat-sync-video && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "beat-sync-video" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-video into .agents/skills/beat-sync-video/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "beat-sync-video", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install BlackBeltTechnology/pi-agent-dashboard beat-sync-video --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/music-production/.pi/skills/beat-sync-video .cursor/skills/beat-sync-video && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "beat-sync-video" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-video into .cursor/skills/beat-sync-video/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "beat-sync-video", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/BlackBeltTechnology/pi-agent-dashboard.git --path packages/music-production/.pi/skills/beat-sync-video--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install BlackBeltTechnology/pi-agent-dashboard beat-sync-video --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/music-production/.pi/skills/beat-sync-video .gemini/skills/beat-sync-video && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "beat-sync-video" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-video into .gemini/skills/beat-sync-video/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "beat-sync-video", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install BlackBeltTechnology/pi-agent-dashboard beat-sync-videoInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/music-production/.pi/skills/beat-sync-video .github/skills/beat-sync-video && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "beat-sync-video" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-video into .github/skills/beat-sync-video/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "beat-sync-video", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install BlackBeltTechnology/pi-agent-dashboard beat-sync-video --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/music-production/.pi/skills/beat-sync-video .opencode/skills/beat-sync-video && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "beat-sync-video" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/music-production/.pi/skills/beat-sync-video into .opencode/skills/beat-sync-video/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "beat-sync-video", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
beat-sync-video- GitHub stars
- 315
- Token cost
- ~1k tokens
- SKILL.md length
- 471 words
- Files
- 2 (incl. scripts)
- Skills in repo
- 70
- Repo updated
- First seen
- Licence
- MIT
At a glance
Lock a picture edit to a music edit: scene boundaries on downbeats and drops, plus irregular camera-punch hits from bass re-entries and vocal hooks (<stemhits.json, schema music-hits/1) with a…
- Works in 5 steps: Lock the scene grid → Pick the hits → Punch recipe → …
- Tasks that involve Motion graphics
- SKILL.md covers 1. Lock the scene grid, 2. Pick the hits, 3. Punch recipe and 4. HyperFrames adapter, plus 1 more section
- Runs Python scripts from its folder; calls python
What it does
Beat Sync Video is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Lock a picture edit to a music edit: scene boundaries on downbeats and drops, plus irregular camera-punch hits from bass re-entries and vocal hooks (<stemhits.json, schema music-hits/1) with a HyperFrames adapter recipe. Use on "sync the video to the beat", "add camera punches on the drops", "cut on the music", "make the edit hit the drop".
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/pick_hits.py`).
It sits in Media & Creative, covering Motion graphics. It works with HeyGen. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.
When your agent uses it
- Tasks that involve Motion graphics
Example prompts
- “sync the video to the beat”
- “add camera punches on the drops”
- “cut on the music”
- “/beat-sync-video”
Requirements
- Python 3
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 7a2d171. 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 1 file in scripts/ (Python), 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
Beat Sync Video loads about 1k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 471 words of instructions outside code blocks.
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); the scripts in this folder are not scanned.
SKILL.md
The full file from BlackBeltTechnology/pi-agent-dashboard at commit 7a2d171, republished under its MIT licence (© BlackBeltTechnology). 471 words, ~1,009 tokens.
Download SKILL.mdSave it as
.claude/skills/beat-sync-video/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- beat-sync-video
- description
- Lock a picture edit to a music edit: scene boundaries on downbeats and drops, plus irregular camera-punch hits from bass re-entries and vocal hooks (<stem>_hits.json, schema music-hits/1) with a HyperFrames adapter recipe. Use on "sync the video to the beat", "add camera punches on the drops", "cut on the music", "make the edit hit the drop".
beat-sync-video
Input: an approved music-edit/1 from music-edit-to-length. Output:
<stem>_hits.json and a picture edit whose scenes sit on the music grid.
Scripts run in the quick-tier venv (.venv-music); PKG=<this skill dir>/../../...
1. Lock the scene grid
- The composition's root duration = music duration (
durationof_edit.json). - Scene starts come from
downbeats_video— every scene boundary is a downbeat. - Put a scene boundary on each confirmed drop (the drop-aligned boundary): the new scene starts exactly on the drop's video time.
- To land that boundary, compress or stretch the scene before the drop (trim or speed-ramp its shots, drop a shot, or hold the last one) so that it ends exactly on the drop downbeat. Never shift the drop to fit the picture.
2. Pick the hits
.venv-music/bin/python "$PKG/.pi/skills/beat-sync-video/scripts/pick_hits.py" music/track_edit90_edit.json \
[--min-gap 1.5] [--hook-db -30] [--density 7]- Structural hits: downbeats with the largest 30–150 Hz jump on the edited audio.
One within ±1 downbeat of a confirmed drop (confidence ≥ 0.5) becomes
big, snapped to the drop; the rest aremid. - Hook hits (needs a vocals stem from the deep tier): bars where the vocals bar-RMS
crosses
--hook-dbfrom below. Without stems the script says hook detection was skipped. - Spacing is irregular by construction: a minimum gap (bars), about one hit per
--densityseconds, and a mechanical every-N-bars grid is thinned until ≤ 70 % of intervals are identical. - Hand-placed hits: add
{"t": …, "tier": "big", "source": "manual", "why": "…"}to_hits.json. Manual hits are never thinned and survive every re-run.
music-hits/1: schema, edit (relative path), hits[] {t, tier: big|mid, source: structural|hook|manual, why} sorted by video time, recipe {big, mid}.
3. Punch recipe
| Tier | Scale | y | x | Rotation | Settle | Easing |
|---|---|---|---|---|---|---|
| big | 1.12 | −48 px | ±36 px | 0.8° | 0.6 s | expo.out |
| mid | 1.07 | −28 px | ±18 px | 0.4° | 0.45 s | expo.out |
Read the values from recipe{} in _hits.json — never duplicate the constants in a
generator. Alternate the horizontal jolt direction per hit (+x, −x, +x …).
Show full SKILL.md (181 more words)Show less
4. HyperFrames adapter
- Wrap each scene's content in a
.camwrapper INSIDE each sub-composition (<div class="cam" id="s6-cam">…</div>incompositions/s6.html). Root-level transforms do not reach sub-composition content, so a punch on the root host does nothing. - One seek-safe tween per hit, from the recipe values back to identity, at the
scene-local time
hit.t − scene.start:js tl.fromTo("#s6-cam", {scale:1.12, y:-48, x:36, rotation:0.8}, {scale:1, y:0, x:0, rotation:0, duration:0.6, ease:"expo.out", immediateRender:false}, 0.000);immediateRender:falsekeeps earlier frames untouched when HyperFrames seeks. - Put
data-layout-allow-overflowon zoomed shots so the scaled content is not clipped by the layout checker. - Generate the adapter code from
_hits.json; never hand-edit generated HTML.
5. Verification
- Snapshot pair per tier: snapshot the hit frame and a settled frame
(
t + settle + 0.1 s), measure the scale and vertical offset between them (they must match the recipe within a few px). - Edge-bleed check: at peak displacement no frame edge may show the background — inspect all four edges of the hit snapshot; raise the shot's zoom or lower the punch if one does.
- Watch the drop and one mid hit in the preview before the final render.
© BlackBeltTechnology, 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 1 other file (scripts) in packages/music-production/.pi/skills/beat-sync-video of BlackBeltTechnology/pi-agent-dashboard.
- SKILL.md
- scripts/pick_hits.py
Open the folder on GitHubat commit 7a2d171
Compare with similar skills
Beat Sync Video 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Beat Sync Video this skillBlackBeltTechnology/pi-agent-dashboard | 315 | — | ~1k | Automated safety check: Pass | MIT | |
| HyperFrames Animationheygen-com/hyperframes | 60k | 3 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Faceless Explainer Videoheygen-com/hyperframes | 60k | 3 repos | ~7.7k | Automated safety check: Notes | Apache-2.0 | |
| Figma to HyperFramesheygen-com/hyperframes | 60k | 3 repos | ~4.5k | Automated safety check: Notes | Apache-2.0 | |
| HyperFrames Video Entry Pointheygen-com/hyperframes | 60k | 3 repos | ~5.2k | Automated safety check: Pass | Apache-2.0 | |
| Media Useedenfunf/reelmimic | 1.9k | 1 repos | ~2k | Automated safety check: Pass | MIT |
Similar skills
Faceless Explainer Video
heygen-com/hyperframes
Turns an article, notes or a topic brief into an explainer video whose visuals are invented per scene, built frame by frame in HyperFrames with no footage.
Figma to HyperFrames
heygen-com/hyperframes
Imports Figma assets, brand tokens, components and motion into a HyperFrames video composition, using the Figma REST API with a connector or native export for shaders.
HyperFrames Video Entry Point
heygen-com/hyperframes
Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.
Media Use
edenfunf/reelmimic
Agent Media OS, the single skill for every media need in a HyperFrames project.
Hyperframes
boraoztunc/skills
Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML.
More from BlackBeltTechnology/pi-agent-dashboard
All 70 skills in this repoBrowser
BlackBeltTechnology/pi-agent-dashboard
Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.
CI Troubleshoot
BlackBeltTechnology/pi-agent-dashboard
Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…
Debug Dashboard
BlackBeltTechnology/pi-agent-dashboard
Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.
Implement
BlackBeltTechnology/pi-agent-dashboard
Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.
Pi Dashboard
BlackBeltTechnology/pi-agent-dashboard
Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.
Session To Guideline
BlackBeltTechnology/pi-agent-dashboard
Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…
Related
Works with
Categories
Questions about Beat Sync Video
What does Beat Sync Video do?
Lock a picture edit to a music edit: scene boundaries on downbeats and drops, plus irregular camera-punch hits from bass re-entries and vocal hooks (<stemhits.json, schema music-hits/1) with a…. Beat Sync Video is an agent skill from BlackBeltTechnology/pi-agent-dashboard.json, schema music-hits/1) with a HyperFrames adapter recipe.
When should I use Beat Sync Video?
Beat Sync Video fits situations like: tasks that involve Motion graphics.
How do I install Beat Sync Video in Claude Code?
Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a claude-code`. Or copy the skill folder (packages/music-production/.pi/skills/beat-sync-video in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/beat-sync-video in your project. Claude Code loads it when a task matches its description.
How do I install Beat Sync Video in Codex?
Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a codex`. Or copy the skill folder (packages/music-production/.pi/skills/beat-sync-video in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/beat-sync-video in your project. Codex loads it when a task matches its description.
Can I use Beat Sync Video 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 BlackBeltTechnology/pi-agent-dashboard --skill beat-sync-video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/beat-sync-video, .gemini/skills/beat-sync-video, .github/skills/beat-sync-video and .opencode/skills/beat-sync-video in your project.
What does Beat Sync Video need to run?
Going by SKILL.md and its folder, Beat Sync Video needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Beat Sync Video 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 Beat Sync Video 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Beat Sync Video use?
Beat Sync Video 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 Beat Sync Video use?
About 1k tokens (SKILL.md is roughly 4k 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 Beat Sync Video?
Skills that share tags, products or a category with Beat Sync Video: HyperFrames Animation (heygen-com/hyperframes, 60k stars), Faceless Explainer Video (heygen-com/hyperframes, 60k stars), Figma to HyperFrames (heygen-com/hyperframes, 60k stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Beat Sync Video?
BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.
Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.