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

Lets Claude enhance video, extract subtitles and frames, find highlights and transcode through 30 MediaKit tools.

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

byted-mediakit-video lets Claude analyze and enhance video through 30 tools in the mediakit-cli video group. They cover quality enhancement and scoring, frame extraction, speech-to-subtitle and subtitle OCR, subtitle erasing, invisible watermarks, face blur and swap, background matting, highlight clips, scene splitting and transcoding.

Two tools run in Cloud or Local mode and the other 28 are Cloud only. Claude reads the shared skill and then the tool's reference file first. Cutting, joining and other edits go to the editing skill. It loads when you ask for video analysis or smart processing.

Good for

Video teams who enhance quality or erase subtitles at scale
Marketers cutting highlight clips from dramas, films or game recordings
Analysts who need frames, scenes, OCR text or content analysis from video

Install byted-mediakit-video

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

面向视频文件的智能处理、媒资理解、画质治理与画质检测、抽帧、隐私保护、语音转字幕、字幕提取、字幕擦除、水印处理、精彩片段与高光拆条分析生成、剧情结构化与剧本整理、场景与语义分段、画面文字识别、视频转码转封装及抠像换脸等目标。若对象和目标族已明确属于视频增强、视频分析理解、视频内容结构化、从视频提取字幕、语音转字幕、视频字幕识别或擦除、视频隐私脱敏、视频媒资探测或分发适配，但具体能力不确定，可先加载本 Skill 探索。

Sections in SKILL.md

使用规则
澄清与跨域路由
工具列表

Key facts

Author: volcengine (repo owner)
License: MIT
Installs on skills.sh: 12,272 (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: 32 files including SKILL.md: LICENSE and 30 reference files (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)
Tools: 30: 2 run in Cloud or Local mode, 28 are Cloud only
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

Embed a hidden number in a video
Cloud only.
Network · add-video-invisible-watermark
Find highlights in short dramas or mini games, with scores and OCR text
Cloud only.
Network · analyze-video-highlights
Turn long videos into structured plot segments and a highlight storyline
Cloud only.
Network · analyze-video-storyline
Speech to timestamped subtitle text from a video or audio track
Cloud only.
Network · asr-subtitles
Score video quality
Cloud only.
Network · assess-video-quality
Make a narrated recap with AI voice and subtitles from a finished script task
Cloud only.
Network · drama-recap
Make a new narration video from short-drama highlights
Cloud only.
Network · drama-recap-vertical
Turn a short-drama video into a script of scenes, characters and dialogue
Cloud only.
Network · drama-script
AI quality enhancement in standard and professional versions
Cloud only.
Network · enhance-video
Speed-first enhancement for latency-sensitive jobs
Cloud only.
Network · enhance-video-fast
Diffusion-based enhancement and repair
Cloud only.
Network · enhance-video-generative
Detect and erase burned-in subtitles, keeping the background
Cloud only.
Network · erase-video-subtitle
Higher-quality subtitle erasing
Cloud only.
Network · erase-video-subtitle-pro
Pull screenshots for covers, previews, sprites or analysis
Cloud only.
Network · extract-frames
Read the hidden number back from a watermarked video
Cloud only.
Network · extract-video-invisible-watermark
Blur or mosaic every face in a video
Cloud only.
Network · face-blur-video
Replace faces in a video with a face you provide
Cloud only.
Network · face-swap-video
Cut highlight reels and episode trailers from short dramas
Cloud only.
Network · generate-highlights-microdrama
Cut promo clips from mini-game recordings
Cloud only.
Network · generate-highlights-minigame
Split films and series into highlight clips of set length
Cloud only.
Network · generate-highlights-movie
Smart transcoding that picks encoder settings for lower bitrate
Cloud only.
Network · martencode-video
Remove a green or solid-color background
Runs in Cloud or Local mode.
Runs code · matte-greenscreen-video
Remove the background behind a person
Cloud only.
Network · matte-portrait-video
Read standard media info for a video URL
Runs in Cloud or Local mode.
Runs code · probe-video-metadata
Change the container format without re-encoding
Cloud only.
Network · remux-video
Split a video into scenes with a timeline and separate clips
Cloud only.
Network · segment-scenes
Split a video at natural breaks using picture, speech and story
Cloud only.
Network · semantic-segment
Convert codec, resolution, bitrate, keyframe interval or container
Cloud only.
Network · transcode-video
Read burned-in subtitles as timestamped text
Cloud only.
Network · video-ocr
General content analysis for a list of video URLs
Cloud only.
Network · video-understand-router

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

Cloud tools send your media to MediaKit
Input goes to MediaKit's cloud as a public HTTP/HTTPS URL, a MediaKit, VOD or TOS link, or, for tools that accept it, a local file path that the CLI's media adapter uploads (per byted-mediakit-shared SKILL.md). 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. The enhance-video reference says its standard or professional version also affects billing. 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
Output can be written to your own storage
Cloud tool references describe an optional media_output_destination (vod://space or tos://bucket). Setting it stores results in your Volcengine VOD space or TOS bucket, and the first use needs you to authorize MediaKit to write there. Claude is told to pass it only if you give it. 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-video do?

It lets Claude analyze and enhance video through mediakit-cli. It can improve quality, extract frames, turn speech into subtitles, erase subtitles, add or read invisible watermarks, blur faces, remove backgrounds, find highlights and transcode.

How do I install byted-mediakit-video?

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.

Does it also generate subtitles from speech?

Yes. asr-subtitles turns the speech in a video or audio track into timestamped text. SKILL.md says it reads the audio, not subtitles already burned into the picture. video-ocr reads those.

Which tools run locally?

Two of the 30: matte-greenscreen-video and probe-video-metadata run in Cloud or Local mode. The other 28 are Cloud only. The README's feature table lists all 30 video tools as Cloud, so trust SKILL.md and each tool's --schema for the mode.

Does it change faces or remove marks?

It has tools that do. face-swap-video replaces faces with one you provide, face-blur-video hides faces, and the erase-video-subtitle tools remove burned-in subtitles. Use them only on media you have the right to change.

Is it safe?

Installing the skill copies files only: the folder holds SKILL.md, a LICENSE and 30 reference files, with no scripts. Using it makes Claude run mediakit-cli in your shell, and nearly all video tools are Cloud, so your video goes to MediaKit's cloud and your API key is used. 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-video

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
byted-mediakit-video SKILL.md · github.com