Agent skill

Beatdesign Workspace

by BeatAPI in BeatAPI/BeatDesign

操作本地 BeatDesign 项目中的 Canvas、Assets、生成任务、视频时间线和字幕;在用户要求创作、整理、检查或剪辑媒体时使用。

Apache-2.0Auto-check passedMedia & Creative

Install Beatdesign Workspace

skills CLI
$ npx skills add BeatAPI/BeatDesign --skill beatdesign-workspace -a claude-code

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

GitHub CLI
$ gh skill install BeatAPI/BeatDesign beatdesign-workspace --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/BeatAPI/BeatDesign.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/workbuddy/beatdesign/skills/beatdesign-workspace .claude/skills/beatdesign-workspace && 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
beatdesign-workspace
GitHub stars
108
Used in
1 other repo
Token cost
~632 tokens
SKILL.md length
180 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

操作本地 BeatDesign 项目中的 Canvas、Assets、生成任务、视频时间线和字幕;在用户要求创作、整理、检查或剪辑媒体时使用。

  • Works in 5 steps: 如果 BeatDesign 工具不可用,请用户在 WorkBuddy… → 目标项目不明确时,先调用 bdesign_project_list。 → 调用一次 bdesign_project_target 绑定当前会话;之后可省略 → …
  • Tasks that involve AI video generation
  • SKILL.md covers 开始任务, 面向中文用户的沟通, 安全修改 and 字幕, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Beatdesign Workspace is an agent skill from BeatAPI/BeatDesign. 操作本地 BeatDesign 项目中的 Canvas、Assets、生成任务、视频时间线和字幕;在用户要求创作、整理、检查或剪辑媒体时使用。

Its SKILL.md is about 630 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, covering AI video generation, Image generation and Video production. It works with Model Context Protocol, FFmpeg and React. The repository describes itself as: Local-first AI canvas and timeline. Any MCP agent. Open-source alternative to Higgsfield. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve AI video generation
  • Tasks that involve Image generation
  • Tasks that involve Video production

Example prompts

  • “/beatdesign-workspace”

Workflow steps

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

  1. 如果 BeatDesign 工具不可用,请用户在 WorkBuddy 中重试或重新安装
  2. 目标项目不明确时,先调用 bdesign_project_list。
  3. 调用一次 bdesign_project_target 绑定当前会话;之后可省略
  4. 任务开始时调用 bdesign_project_open,保存返回的
  5. Canvas 改动后用 bdesign_canvas_view 聚焦对应 cardId;时间线改动后用

What it can do on your machine

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

    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

Beatdesign Workspace loads about 632 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 180 words of instructions outside code blocks.

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

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 BeatAPI/BeatDesign at commit d2ef270, republished under its Apache-2.0 licence (© BeatAPI). 180 words, ~632 tokens.

Download SKILL.mdSave it as .claude/skills/beatdesign-workspace/SKILL.md (or your agent's skills folder).
name
beatdesign-workspace
description
操作本地 BeatDesign 项目中的 Canvas、Assets、生成任务、视频时间线和字幕;在用户要求创作、整理、检查或剪辑媒体时使用。

BeatDesign 本地工作台

BeatDesign MCP 是结构化控制层,浏览器中的 BeatDesign 是用户审核界面;二者操作同一个本地 Project、Assets、Canvas、Timeline 和命令历史。

开始任务

  1. 如果 BeatDesign 工具不可用,请用户在 WorkBuddy 中重试或重新安装 Connector。若提示 3020 端口被占用,先关闭正在运行的其他 BeatDesign 工作台,再重新连接;公共 Connector 不要求用户克隆仓库或运行 pnpm。
  2. 目标项目不明确时,先调用 bdesign_project_list。
  3. 调用一次 bdesign_project_target 绑定当前会话;之后可省略 projectId。
  4. 任务开始时调用 bdesign_project_open,保存返回的 workspaceUrl。
  5. Canvas 改动后用 bdesign_canvas_view 聚焦对应 cardId;时间线改动后用 bdesign_editor_view 定位到相关时间。

如果 WorkBuddy 可以打开网页,则打开返回的 workspaceUrl;否则把准确链接交给用户,不要声称页面已经打开。

面向中文用户的沟通

  • 用户用中文交流时,使用中文说明步骤和结果。把 Canvas、Assets、Editor、SRT 分别称作“画布、素材库、剪辑页面、字幕文件”;只有用户需要识别文件格式时才补充 SRT。
  • 用户第一次使用时,先说明项目和媒体保存在本机;整理素材、剪辑和预览不需要 BeatAPI 密钥。只有用户确认远程 AI 生成或分析后,才引导其配置密钥并提交。
  • 打开 workspaceUrl 后,请用户在中文界面核对实际画面或字幕;如果浏览器语言未 自动匹配,可用页面右上角的语言切换器选择“中文”。不要把数据库写入成功当作用户已看见结果。
  • 遇到 Project not found,用“没有找到这个项目,请先从项目列表选择”解释; 遇到 3020 端口冲突,用“另一个 BeatDesign 工作台正在运行”解释。缺少 ffmpeg 或 ffprobe 时,说明对应的尾帧提取或完整时间线渲染暂不可用, 再给有需要的用户安装路径提示,不要把原始报错直接当成最终答复。

安全修改

  • 修改前读取当前 Canvas 或 Editor 状态。
  • 只使用带稳定 ID、revision 和幂等键的增量操作,不覆盖完整 Canvas 或 Timeline。
  • 返回 retry 时,读取最新状态后按说明重试一次,不循环重试。
  • 本地媒体先通过 bdesign_asset_import 导入,再放进 Canvas 或 Editor。
  • 生成结果先成为 Project Asset;是否放进 Canvas/Editor 是下一步操作。

字幕

  • 完整 SRT 文件或文本优先使用 bdesign_editor_import_srt;单条调整才使用 bdesign_editor_edit 的 upsert_caption。
  • SRT 校验失败不会改变原字幕。报告解析错误,不要清空或部分覆盖字幕轨。
  • 导入后用 bdesign_editor_view 停在第一条相关字幕,让用户检查文字、时间、换行和预览效果。

尾帧续写

  • bdesign_canvas_continue_from_tail 使用一个稳定 command ID;传输结果不确定时复用同一 ID,避免重复创建帧 Asset 或续写节点。
  • 提交生成前,先调用返回的 review tool,让用户检查抽取帧和续写节点。
  • 若提示缺少 ffmpeg,请用户把它加入 BeatDesign MCP 进程的 PATH,或设置绝对路径 BEATDESIGN_FFMPEG;环境未改变前不要重复调用。
  • 抽帧和放置节点是本地操作;返回的生成请求是单独的远程付费动作,只有用户明确授权后才能提交。
  • 生成成功只会创建 Asset。用 bdesign_canvas_apply 把输出更新到返回的生成卡片,再调用 bdesign_canvas_view 聚焦它。

导出权威时间线

  • 用户明确授权导出后,先调用 bdesign_editor_get,再使用返回的 revision 调用 bdesign_editor_render。结果是项目内 MP4 Asset,包含可见 Clip、图片 Overlay、烧录字幕和混合音频。
  • 若提示缺少 ffmpeg 或 ffprobe,请用户把两者加入 MCP 进程的 PATH,或设置绝对路径 BEATDESIGN_FFMPEG 和 BEATDESIGN_FFPROBE;环境未改变前不要重复调用。
  • 会影响画面的时间线修改会让上一版当前导出失效,但不会删除历史 Asset。若导出期间时间线发生变化,先读取最新 revision,再询问用户是否重新导出。

完成标准

写入后核对返回的 revision 和变更 ID,再调用对应 view tool。Canvas 和 Editor 当前通常会在约两秒内或页面重新聚焦时读到 Agent 修改。最终提供准确的 workspaceUrl 供用户审核;仅有数据库 revision 不代表用户已经看到结果。

未获明确授权时,不要导出、提交付费生成或额外创建多个版本。

© BeatAPI, 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 integrations/workbuddy/beatdesign/skills/beatdesign-workspace of BeatAPI/BeatDesign.

Open the folder on GitHubat commit d2ef270

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in BeatAPI/BeatDesign, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Beatdesign Workspace 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.

Beatdesign Workspace compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Beatdesign Workspace this skillBeatAPI/BeatDesign1081 repos~632Automated safety check: PassApache-2.0
AI Mediaericrisco/rsc-harness156—~3.3kAutomated safety check: PassMIT
Cassette Video EditCassette-Editor/oh-my-cassette1571 repos~3.4kAutomated safety check: PassMIT
Cassette ModelCassette-Editor/oh-my-cassette1571 repos~374Automated safety check: PassMIT
Blender MCP Videomicky-li-hd/VideoCoCo115—~1.1kAutomated safety check: PassNone
Cassette Gateway Video EditCassette-Editor/oh-my-cassette157—~4kAutomated safety check: PassMIT

Similar skills

  • AI Media

    ericrisco/rsc-harness

    A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…

    156 GitHub stars~3.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Cassette Video Edit

    Cassette-Editor/oh-my-cassette

    Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette.

    157 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed
  • Cassette Model

    Cassette-Editor/oh-my-cassette

    Show or change the Cassette editing model and thinking level for the current media session.

    157 GitHub starsUsed in 1 repo~374 tokens
    Media & CreativeAuto-check passed
  • Blender MCP Video

    micky-li-hd/VideoCoCo

    A skill your agent uses for Blender MCP or Blender CLI video-generation work, especially when rendering scripted Blender scenes, debugging MCP port 9876, checking why blender is not on PATH…

    115 GitHub stars~1.1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Cassette Gateway Video Edit

    Cassette-Editor/oh-my-cassette

    Add Hermes gateway media ingestion, background notification, and delivery behavior to the canonical cassette-video-edit MCP workflow.

    157 GitHub stars~4k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Editorial Collage Motion

    Pluviobyte/rnskill

    将参考图或简要描述解码为可编辑的半色调纸张拼贴规范,默认使用 Codex 内置 imagegen 生成品牌一致的静帧和透明图层,再用本地 FFmpeg 或 HyperFrames 制作“从空背景逐件组装”的确定性动态视频。用户提到半色调拼贴、纸张拼贴、剪纸拼贴、编辑式拼贴、杂志拼贴、复古印刷拼贴、拼贴动效、拼贴动画、剪纸动画、纸片组装、逐层组装、从无到有、元素飞入拼装、定格拼贴、定格动画、Arc…

    1.6k GitHub stars~1.2k tokensUpdated 16 days ago
    Media & CreativeAuto-check passed

More from BeatAPI/BeatDesign

  • Beatdesign Workspace

    BeatAPI/BeatDesign

    Operate a local BeatDesign project through MCP when the user asks to create, organize, generate, inspect, or edit media in BeatDesign, including captions, tail-frame continuation, and opening the…

    108 GitHub stars~1.1k tokensUpdated 14 days ago
    Auto-check passed
  • Beatdesign Workspace

    BeatAPI/BeatDesign

    Operate a local BeatDesign project through MCP when the user asks to create, organize, generate, inspect, or edit media in BeatDesign, including opening the exact Canvas or Editor in Codex for…

    108 GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed

Questions about Beatdesign Workspace

What does Beatdesign Workspace do?

操作本地 BeatDesign 项目中的 Canvas、Assets、生成任务、视频时间线和字幕;在用户要求创作、整理、检查或剪辑媒体时使用。. Beatdesign Workspace is an agent skill from BeatAPI/BeatDesign.

When should I use Beatdesign Workspace?

Beatdesign Workspace fits situations like: tasks that involve AI video generation; tasks that involve Image generation; tasks that involve Video production.

How do I install Beatdesign Workspace in Claude Code?

Run `npx skills add BeatAPI/BeatDesign --skill beatdesign-workspace -a claude-code`. Or copy the skill folder (integrations/workbuddy/beatdesign/skills/beatdesign-workspace in BeatAPI/BeatDesign) into .claude/skills/beatdesign-workspace in your project. Claude Code loads it when a task matches its description.

How do I install Beatdesign Workspace in Codex?

Run `npx skills add BeatAPI/BeatDesign --skill beatdesign-workspace -a codex`. Or copy the skill folder (integrations/workbuddy/beatdesign/skills/beatdesign-workspace in BeatAPI/BeatDesign) into .agents/skills/beatdesign-workspace in your project. Codex loads it when a task matches its description.

Can I use Beatdesign Workspace 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 BeatAPI/BeatDesign --skill beatdesign-workspace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/beatdesign-workspace, .gemini/skills/beatdesign-workspace, .github/skills/beatdesign-workspace and .opencode/skills/beatdesign-workspace in your project.

What does Beatdesign Workspace need to run?

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

Does Beatdesign Workspace 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 Beatdesign Workspace 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 Beatdesign Workspace use?

Beatdesign Workspace 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 Beatdesign Workspace use?

About 632 tokens (SKILL.md is roughly 2.5k 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 Beatdesign Workspace?

Skills that share tags, products or a category with Beatdesign Workspace: AI Media (ericrisco/rsc-harness, 156 stars), Cassette Video Edit (Cassette-Editor/oh-my-cassette, 157 stars), Cassette Model (Cassette-Editor/oh-my-cassette, 157 stars) and Blender MCP Video (micky-li-hd/VideoCoCo, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Beatdesign Workspace?

BeatAPI (a GitHub organization) maintains it in BeatAPI/BeatDesign, which has 108 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 23, 2026.

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