New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Beatdesign Workspace

by BeatAPI in 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…

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/claude-code/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
114
Token cost
~1.1k tokens
SKILL.md length
598 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

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…

  • Works in 5 steps: If BeatDesign tools are unavailable,… → Call bdesign_project_list when the… → Call bdesign_project_target once. Later… → …
  • Edit media in BeatDesign
  • SKILL.md covers Establish the visible project, Change the shared project safely, Import captions and Continue from a video's tail…, plus 2 more sections
  • Calls pnpm

What it does

Beatdesign Workspace is an agent skill from 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 exact Canvas or Editor review URL.

Its SKILL.md is about 1.1k 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 MCP servers, AI video generation and Image generation. It works with Model Context Protocol 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

  • Edit media in BeatDesign
  • Including captions
  • Tail-frame continuation
  • Opening the exact Canvas

Example prompts

  • “/beatdesign-workspace”

Workflow steps

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

  1. If BeatDesign tools are unavailable, tell the user to run pnpm dev:agent
  2. Call bdesign_project_list when the target project is not unambiguous.
  3. Call bdesign_project_target once. Later project-scoped tools may omit
  4. Call bdesign_project_open near the start with the view that matches the
  5. For Canvas review, call bdesign_canvas_view with the changed cardId. For

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

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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 1.1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 598 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
~1.1k

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). 598 words, ~1,126 tokens.

Download SKILL.mdSave it as .claude/skills/beatdesign-workspace/SKILL.md (or your agent's skills folder).
name
beatdesign-workspace
description
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 exact Canvas or Editor review URL.

BeatDesign workspace

Use BeatDesign MCP as the semantic control plane and the BeatDesign browser workspace as the review surface. Both operate the same local Project, Assets, Canvas, Timeline, and command history.

Establish the visible project

  1. If BeatDesign tools are unavailable, tell the user to run pnpm dev:agent in their BeatDesign clone, then reconnect the plugin from /mcp.
  2. Call bdesign_project_list when the target project is not unambiguous.
  3. Call bdesign_project_target once. Later project-scoped tools may omit projectId for this MCP session.
  4. Call bdesign_project_open near the start with the view that matches the task. Preserve its workspaceUrl as the visible review handoff.
  5. For Canvas review, call bdesign_canvas_view with the changed cardId. For timeline review, call bdesign_editor_view at the relevant time.

Open the returned workspaceUrl when the host provides a browser or preview surface. Otherwise return the exact URL to the user; do not claim the page was opened when the host cannot open it.

Change the shared project safely

  • Read the current Canvas or Editor state before editing.
  • Use incremental Canvas and Editor operations with stable IDs and one stable idempotency key. Never replace a complete Canvas or Timeline document.
  • If a result still includes retry, read the newest state and follow that instruction once. Do not busy-loop.
  • Import local media through bdesign_asset_import before referencing it from Canvas or Editor.
  • Treat generation as asset-first: output becomes a Project Asset before it is placed on Canvas or Editor.

Import captions

  • Prefer bdesign_editor_import_srt for a file or complete SRT text. Use bdesign_editor_edit with upsert_caption only for targeted cue changes.
  • A malformed SRT import leaves saved captions unchanged. Report the parse error instead of clearing or partially replacing the track.
  • After import, call bdesign_editor_view at the first relevant cue and ask the user to inspect text, timing, wrapping, and line breaks in the Editor.
Show full SKILL.md (295 more words)Show less

Continue from a video's tail frame

  • Call bdesign_canvas_continue_from_tail with one stable command ID. Reuse that ID if delivery is uncertain so retries reuse the derived frame Asset and continuation node.
  • Call the returned review tool before generation so the extracted frame and continuation node can be inspected.
  • If frame extraction reports that ffmpeg is unavailable, stop and explain that the BeatDesign MCP process needs ffmpeg on PATH or an absolute BEATDESIGN_FFMPEG value.
  • Tail-frame extraction and Canvas placement are local deterministic work. The returned generation request is a separate remote action: submit it only when the user authorized that generation and its provider cost.
  • A successful generation creates an Asset but does not place itself. Update the returned generation card with that output through bdesign_canvas_apply, then focus the same card with bdesign_canvas_view.

Export the authoritative timeline

  • When the user authorizes an export, call bdesign_editor_get, then call bdesign_editor_render with the returned revision. The result is a project-owned MP4 Asset containing visible clips, image overlays, caption burn-in, and mixed audio.
  • If rendering reports that ffmpeg or ffprobe is unavailable, stop and explain that the MCP process needs those binaries on PATH, or absolute BEATDESIGN_FFMPEG and BEATDESIGN_FFPROBE paths.
  • Render-affecting edits invalidate the previous current render without deleting its historical Asset. If the timeline changes while rendering, read the latest revision and ask before starting another render.

Verify the visible result

After a write, read the returned revision and changed IDs. Canvas and Editor currently refresh external revisions within about two seconds and on focus. Use the relevant view tool and leave the user with the exact workspaceUrl. A database revision alone is not proof of a successful visible operation.

Do not export, submit a paid generation, or create extra variants unless the user's request clearly authorizes that exact action.

© 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/claude-code/beatdesign/skills/beatdesign-workspace of BeatAPI/BeatDesign.

Open the folder on GitHubat commit d2ef270

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/BeatDesign114—~1.1kAutomated safety check: PassApache-2.0
Cassette Video EditCassette-Editor/oh-my-cassette1571 repos~3.4kAutomated safety check: PassMIT
Qiaomu Codex Imagegenjoeseesun/qiaomu-codex-imagegen114—~2.3kAutomated safety check: PassMIT
Bailian Media Generationmodelstudioai/cli542—~2kAutomated safety check: PassApache-2.0
Gemini Interactions APIAyuilos/Miffan192—~4.6kAutomated safety check: PassAGPL-3.0
Clipmivo VideoBarneyD66/clipmivo-tools142—~945Automated safety check: PassMIT

Similar skills

  • 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

  • Qiaomu Codex Imagegen

    joeseesun/qiaomu-codex-imagegen

    Generate or edit images with Codex's built-in image generation from any agent, through an MCP tool or a plain CLI.

    114 GitHub stars~2.3k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed

  • Bailian Media Generation

    modelstudioai/cli

    Chinese-language entry point into Alibaba Cloud Bailian's image, video and speech generation and understanding, routed through separate image, video, speech and vision commands.

    542 GitHub stars~2k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed

  • Gemini Interactions API

    Ayuilos/Miffan

    A skill your agent uses when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, video generation, streaming responses…

    192 GitHub stars~4.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed

  • Clipmivo Video

    BarneyD66/clipmivo-tools

    Create and manage AI video tasks through ClipmivoAI using its MCP server, CLI or REST API.

    142 GitHub stars~945 tokensUpdated 22 days ago
    Media & CreativeAuto-check passed

  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    392 GitHub stars~2.7k tokensUpdated today
    Media & CreativeAuto-check passed

More from BeatAPI/BeatDesign

  • Beatdesign Workspace

    BeatAPI/BeatDesign

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

    114 GitHub starsUsed in 1 repo~632 tokens
    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…

    114 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check passed

Works with

Categories

Questions about Beatdesign Workspace

What does Beatdesign Workspace do?

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…. Beatdesign Workspace is an agent skill from 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 exact Canvas or Editor review URL.

When should I use Beatdesign Workspace?

Beatdesign Workspace fits situations like: edit media in BeatDesign; including captions; tail-frame continuation; opening the exact Canvas.

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/claude-code/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/claude-code/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?

Going by SKILL.md and its folder, Beatdesign Workspace needs the command-line tools its instructions call (pnpm).

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 1.1k tokens (SKILL.md is roughly 4.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: Cassette Video Edit (Cassette-Editor/oh-my-cassette, 157 stars), Qiaomu Codex Imagegen (joeseesun/qiaomu-codex-imagegen, 114 stars), Bailian Media Generation (modelstudioai/cli, 542 stars) and Gemini Interactions API (Ayuilos/Miffan, 192 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 114 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.