Agent skill

Beat Sync Video

by ZJU-REAL in ZJU-REAL/Easel

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow…

Apache-2.0Auto-check passed

Install Beat Sync Video

skills CLI
$ npx skills add ZJU-REAL/Easel --skill beat-sync-video -a claude-code

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

GitHub CLI
$ gh skill install ZJU-REAL/Easel beat-sync-video --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/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/beat-sync-video .claude/skills/beat-sync-video && 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
beat-sync-video
GitHub stars
3.4k
Token cost
~492 tokens
SKILL.md length
108 words
Files
1
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow…

  • Works in 5 steps: 音乐节奏越明确卡点越准;无明显节拍时脚本自动退化为等间隔切换并在报告说明。 → 卡点用硬切(不加转场),否则会糊掉节拍感——这是刻意设计。 → 素材不足自动循环;素材充足时建议 --every 1~2 让每段都换新画面。 → …
  • SKILL.md covers 输入, 输出(outputs/主题名/), 执行步骤 and Profile 感知, plus 2 more sections
  • Calls python

What it does

Beat Sync Video is an agent skill from ZJU-REAL/Easel. 音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow 每图固定时长、柔和转场,本 SKILL 切换点由音乐节拍决定、硬切踩点带特效。

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

The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

Example prompts

  • “/beat-sync-video”

Requirements

  • Python 3

Workflow steps

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

  1. 音乐节奏越明确卡点越准;无明显节拍时脚本自动退化为等间隔切换并在报告说明。
  2. 卡点用硬切(不加转场),否则会糊掉节拍感——这是刻意设计。
  3. 素材不足自动循环;素材充足时建议 --every 1~2 让每段都换新画面。
  4. 成片默认跟音乐等长,用 --max-duration 卡平台时长。
  5. 产物统一进 outputs/主题名/。

What it can do on your machine

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

    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 492 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 108 words of instructions outside code blocks.

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

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 ZJU-REAL/Easel at commit 278f420, republished under its Apache-2.0 licence (© ZJU-REAL). 108 words, ~492 tokens.

Download SKILL.mdSave it as .claude/skills/beat-sync-video/SKILL.md (or your agent's skills folder).
name
beat-sync-video
description
音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow 每图固定时长、柔和转场,本 SKILL 切换点由音乐节拍决定、硬切踩点带特效。
layer
produce

音乐卡点视频(踩点混剪)

用 librosa 检测背景音乐节拍,让画面在节拍上硬切换,配节拍特效,做"踩点"燃系短视频。 全部走 skills/shared/scripts/beatsync.py,不要手数节拍、手拼滤镜——脚本已做 节拍检测、区间切分、素材循环、音画对齐。

每图固定时长的柔和相册见 slideshow-video;主题→AI 配图配音成片见 auto-short-video。

输入

字段必填说明
背景音乐是决定卡点的音乐文件(节奏越强效果越好;没给就问)
素材是一组图片和/或短片段(按顺序,循环使用),或一个目录
画幅是用户或上游任务未明确横版/竖版(或具体分辨率)时,制作前必须追问并等确认;不得按平台、Profile 或默认值静默推断,已明确则不重复问
切换频率否每几拍切一次(默认每 2 拍)
特效否zoom 推进(默认)/ flash 白闪 / none

输出(outputs/主题名/)

  • 卡点成片(*.mp4)
  • 报告:卡点段数、总时长、检测到的 BPM、特效

执行步骤

脚本路径(相对项目根):skills/shared/scripts/beatsync.py(build -h / beats -h)。

1.(可选)先看节拍
bash
python skills/shared/scripts/beatsync.py beats --music <音乐>
# 打印 tempo(BPM) 与节拍时间点,用于判断 --every 该设多少
2. 生成卡点视频
bash
python skills/shared/scripts/beatsync.py build \
  -i 1.jpg 2.jpg 3.jpg 4.jpg --music <音乐> \
  -o outputs/主题名/show.mp4 \
  --size 1080x1920 --every 2 --effect zoom
  • 素材 = 图片或短片段,数量可少于卡点段数(自动循环复用)。
  • --every 1 每拍都切(快闪,素材要多);--every 4 每小节切一次(舒缓)。
  • --effect flash 段首白闪更"燃";--effect none 干净硬切。
  • --max-duration 15 限制成片长度(如做 15s 抖音)。
  • 也可 --images-dir <目录> 批量喂素材(按文件名排序)。

Profile 感知

  • 有 Profile:platforms.md 只用于给出画幅建议,仍须用户确认;卡点风格(快闪/舒缓)与特效贴合账号调性 (潮流/运动账号偏快闪 flash,生活/治愈账号偏 zoom 舒缓)。
  • 无 Profile:先确认横版/竖版;默认每 2 拍、zoom 特效。

规则

  1. 音乐节奏越明确卡点越准;无明显节拍时脚本自动退化为等间隔切换并在报告说明。
  2. 卡点用硬切(不加转场),否则会糊掉节拍感——这是刻意设计。
  3. 素材不足自动循环;素材充足时建议 --every 1~2 让每段都换新画面。
  4. 成片默认跟音乐等长,用 --max-duration 卡平台时长。
  5. 产物统一进 outputs/主题名/。

参考来源

节拍检测用 librosa beat_track(onset 强度 + 动态规划求拍点),画面在拍点硬切是卡点混剪的 标准做法。把节拍→区间→逐段渲染→音画对齐封装成确定性脚本,避免手数拍子对不齐。

© ZJU-REAL, Apache-2.0. 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/openclaw/beat-sync-video of ZJU-REAL/Easel.

Open the folder on GitHubat commit 278f420

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.

Beat Sync Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Beat Sync Video this skillZJU-REAL/Easel3.4k—~492Automated safety check: PassApache-2.0
Beat Sync Montage0xsline/OpenChatCut2.2k—~1.2kAutomated safety check: PassAGPL-3.0
Beat Sync Reelgooseworks-ai/goose-skills1.2k1 repos~2.5kAutomated safety check: NotesMIT
React Syncvercel/next.js143k—~486Automated safety check: PassMIT
Claude-Mem Cloud Syncthedotmack/claude-mem99k—~1kAutomated safety check: NotesApache-2.0
Agent Sync Coordinatorruvnet/ruflo74k2 repos~4kAutomated safety check: PassMIT

Similar skills

  • Beat Sync Montage

    0xsline/OpenChatCut

    Plan and build a finished beat-synced montage where cut placement serves the content, not just the metronome.

    2.2k GitHub stars~1.2k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Beat Sync Reel

    gooseworks-ai/goose-skills

    Generates Instagram Reels where product image cuts are synced to audio beats.

    1.2k GitHub starsUsed in 1 repo~2.5k tokens
    Media & CreativeAuto-check: notes
  • React Sync

    vercel/next.js

    Official

    Build local React changes in the bundle variants consumed by Next.js, sync them into a local Next.js checkout, and test the resulting integration.

    143k GitHub stars~486 tokensUpdated today
    Auto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    99k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Agent skill for sync-coordinator - invoke with $agent-sync-coordinator

    74k GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • Fix Sync

    ClickHouse/ClickHouse

    Fix the "CH Inc sync" job in a pull request. An agent skill from ClickHouse/ClickHouse.

    50k GitHub stars~2.8k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated yesterday
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

Questions about Beat Sync Video

What does Beat Sync Video do?

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow…. Beat Sync Video is an agent skill from ZJU-REAL/Easel.

How do I install Beat Sync Video in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill beat-sync-video -a claude-code`. Or copy the skill folder (skills/openclaw/beat-sync-video in ZJU-REAL/Easel) 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 ZJU-REAL/Easel --skill beat-sync-video -a codex`. Or copy the skill folder (skills/openclaw/beat-sync-video in ZJU-REAL/Easel) 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 ZJU-REAL/Easel --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 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. Review the folder before installing.

What licence does Beat Sync Video use?

Beat Sync Video is published under the Apache-2.0 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 492 tokens (SKILL.md is roughly 2k 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: Beat Sync Montage (0xsline/OpenChatCut, 2.2k stars), Beat Sync Reel (gooseworks-ai/goose-skills, 1.2k stars), React Sync (vercel/next.js, 143k stars) and Claude-Mem Cloud Sync (thedotmack/claude-mem, 99k 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?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,376 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 9, 2026.

Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.