byted-mediakit-shared Skill for Claude: What It Does and How to Install It

Entry skill for the MediaKit command-line tools: routes media jobs to the right skill and covers CLI setup.

Installs: 12.3K; on skills.sh
Stars: 218; on GitHub
Files: 2; besides SKILL.md
Updated: Sep 2026; last repo commit

byted-mediakit-shared is the front door to four media skills: editing, audio, image and video. They all drive the mediakit-cli command-line tool. This skill tells Claude which one to load for your goal, to set MEDIAKIT_SURFACE=skill and MEDIAKIT_RUNTIME on every real call, and to ask you what you want when you only say "process a video".

It also covers installing and checking the CLI, Cloud and Local modes, and fetching results of asynchronous Cloud jobs with shared query-task. Tool parameters live in the domain skills. It loads when you ask for trimming, joining, filters, mixing, subtitles, image processing, video analysis or quality enhancement.

Good for

Anyone who wants Claude to trim, join or enhance video from the command line
Developers setting up mediakit-cli with an agent
Teams who run media jobs in batches and need task results

Install byted-mediakit-shared

Any client

Have these values ready, then replace the placeholders in the snippet.

MEDIAKIT_API_KEY	Required	Cloud API key from the Volcengine console. The README shows local mode without a key.
MEDIAKIT_OUTPUT_PATH	Optional	Folder for local-mode output. The README default is ~/.mediakit/temp.

2
Run this in a terminal.
shell
```
npx @volcengine/mediakit-cli install -y
```

Requires Node.js 18 or later.

The installer sets up the mediakit-cli tool and the skills that ship with it. The editing, audio, image and video skills tell Claude to read byted-mediakit-shared first, so install the set and not one skill alone. There is no Claude app upload route because the skills run the local mediakit-cli command.

From the project README. Source.

What's in the skill

When it loads

MediaKit 是面向音视频与图像处理的专业工具集，覆盖视频剪辑与合成、音频处理、视频理解与增强、图像处理与内容理解等工作流。用户明确提出剪辑、拼接、裁剪、转场、滤镜、运镜、混音、提取字幕、语音转字幕、音视频处理、图片处理、视频分析或画质增强目标时，先加载本 Skill，再按对象和目标选择 audio、editing、image 或 video。不承担具体能力参数说明。

Sections in SKILL.md

使用规则
能力范围
能力选择与优先加载
安装与可用性检查
初始化与检查
命令发现与机器合同
媒体输入
Cloud / Local 模式
异步结果
更新
共享查询协议

Key facts

Author: volcengine (repo owner)
License: MIT
Installs on skills.sh: 12,262 (Nov 2, 2026)
GitHub stars: 218 for the whole volcengine/mediakit-cli repo (Nov 2, 2026)
Last repo commit: Sep 2, 2026
What it includes: 3 files including SKILL.md: LICENSE and reference/query_task.md (no scripts)
Needs: The mediakit-cli command (Node.js 18 or later to install). Cloud tools need an API key, and local mode needs ffmpeg 5.1.x and ffprobe
Skill version: 0.2.1 (from SKILL.md frontmatter)
Hosts named: byted-mediakit-shared lists cursor, claude-code and codex as example values for the MEDIAKIT_RUNTIME setting
Language: SKILL.md and the reference files are written in Chinese. The README links an English version

What it includes

Picks editing, audio, image or video from your goal
Editing for trimming, joining, filters and mixing. Audio for transcoding, speech boundaries and voice separation. Image for resize, OCR and cleanup. Video for analysis, enhancement, subtitles and watermarks.
Read · Route to a domain skill
Asks what you want if you only say 'a video' or 'an image'
SKILL.md says to clarify instead of guessing a tool from the media type.
Read · Ask before guessing
npx installer, version and update checks
SKILL.md lists the npx install command, --skills-only reinstall, version checks and mediakit-cli update.
Runs code · Install and update
Set up the CLI and check local dependencies
Initial setup and a check of the CLI and local processing dependencies.
Runs code · init, config show, doctor
--domains, --help and --schema for a tool's machine contract
Claude reads a tool's help and schema before building its arguments.
Read · Command discovery
Pass local paths or URLs straight to tool parameters
SKILL.md says local files go in as paths and the CLI's media adapter handles upload.
Files · Media input
--cloud and --local override the configured default per command
Local returns results right away. Cloud jobs return a task_id.
Runs code · Cloud and Local modes
Check the status and result of an asynchronous Cloud job
Uses the task_id from a Cloud call. reference/query_task.md describes polling until the job finishes.
Network · shared query-task

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Local files are uploaded when you use cloud tools
SKILL.md tells Claude to pass local file paths and says the CLI's media input adapter handles the upload. The README names cloud-first as the default mode, so check the mode before giving Claude private media. github.com
Cloud calls use your MediaKit API key and Volcengine billing rules
Cloud tools run through the MediaKit API key you create in the Volcengine console. The README says using the cloud APIs means following Volcengine's billing rules, which it links, and it lists no prices here. It describes local mode as zero cost. Read the rules before batch jobs. github.com
The installer and updater run npm packages
The install command runs @volcengine/mediakit-cli through npx, and the README says mediakit-cli update uses npm install -g. Install only if you trust the package. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. Review each command before it runs.
Talks to	MediaKit cloud API on Volcengine (Cloud mode: your media or its URL, plus your API key)
Sign-in and keys	README: MEDIAKIT_API_KEY comes from the Volcengine console. mediakit-cli init stores it using the method you choose (config, shell or export), or you can set it as an environment variable.
Scopes	The skill's frontmatter asks for the shell permission and requires the mediakit-cli binary Claude sets MEDIAKIT_SURFACE=skill and MEDIAKIT_RUNTIME on each real call so the CLI knows the caller Local mode runs ffmpeg and ffprobe on your machine and writes results to ~/.mediakit/temp by default

Questions

What does byted-mediakit-shared do?

It is the entry skill for the MediaKit command-line tools. It tells Claude how to install and check mediakit-cli, which domain skill to load for your goal, and how to read the result of asynchronous Cloud jobs.

How do I install byted-mediakit-shared?

Use the install box at the top of this page. It runs the MediaKit installer, which sets up the mediakit-cli command and the skills together. Then follow the set-up and check step in the box.

Do I need an API key?

For Cloud tools, yes: the README says to get a MediaKit API key from the Volcengine console. The README shows local trimming as running without an API key, and local mode needs ffmpeg 5.1.x and ffprobe.

Can I upload it to the Claude app?

No. The skill runs the local mediakit-cli command through the shell, so it needs a client that can run commands on your machine, such as Claude Code. The README does not document a Claude app route.

Do I need the other MediaKit skills?

Yes for real work. This skill holds no tool parameters. The editing, audio, image and video skills hold them, and each tells Claude to read this shared skill first.

What is the difference between Cloud and Local mode?

Local mode runs ffmpeg on your machine and returns the result immediately. Cloud mode uses MediaKit's cloud API and returns a task_id that you check with shared query-task. The README says --local and --cloud override the default for one command.

Why are the instructions in Chinese?

SKILL.md and the reference files are written in Chinese, and the README links an English version. Claude reads the files in either case, and which language it replies in is not set by these files.

Is it safe?

Installing the skill copies files only: the folder holds SKILL.md, a LICENSE and one reference file, with no scripts. Using it makes Claude run mediakit-cli in your shell, and Cloud tools send your media to MediaKit's cloud and use your API key. Review each command and the mode before it runs. Cloud calls follow Volcengine's billing rules, which the README links.

Information

updated Nov 2, 2026

Repository: volcengine/mediakit-cli
Folder: skills/byted-mediakit-shared

volcengine/mediakit-cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

byted-mediakit-shared SKILL.md · github.com
volcengine/mediakit-cli README · github.com
query_task.md · github.com