PlugWiki

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

Lets Claude resize, compress, crop, watermark, blur and read text in images through 21 MediaKit cloud tools.

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

byted-mediakit-image lets Claude process images through 21 tools in the mediakit-cli image group. They cover resizing, cropping, rotating, flipping, rounding corners, color changes, sharpening, blurring, mosaic, negatives, watermarks, background removal, OCR, quality scoring, face blur, erasing text and icons, and smart crop.

Every image tool is Cloud only. A guide in reference/families/image-size-reduction.md helps Claude choose between slim-image and compress-image. Turning images into video goes to the editing skill, and frame extraction goes to the video skill.

Good for

  • Designers and sellers who resize, crop and clean up many images
  • Teams that read text from images or score image quality
  • Anyone who needs faces or details masked before sharing

Install byted-mediakit-image

Any client

  1. 1

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

    MEDIAKIT_API_KEYRequiredCloud API key from the Volcengine console. The README shows local mode without a key.
    MEDIAKIT_OUTPUT_PATHOptionalFolder for local-mode output. The README default is ~/.mediakit/temp.
  2. 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

  1. 使用规则
  2. 图片体积治理与跨域路由
  3. 工具列表

Key facts

Author
volcengine (repo owner)
License
MIT
Installs on skills.sh
12,259 (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
24 files including SKILL.md: LICENSE and 22 reference files, one of them a size-reduction guide (no scripts)
Needs
The mediakit-cli command (Node.js 18 or later to install) and a MediaKit API key, because every image tool is Cloud only
Skill version
0.2.1 (from SKILL.md frontmatter)
Tools
21, all 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

  • Add a text or image watermark

    Cloud only.

    Network · add-image-watermark

  • Adjust brightness, contrast and saturation with six quick effects

    Cloud only.

    Network · adjust-image-color

  • Lossy compression and format conversion with quality, size or format settings

    Cloud only.

    Network · compress-image

  • Crop by direction, target area, custom box or inscribed circle

    Cloud only.

    Network · crop-image

  • Raise resolution, sharpness and color based on the image content

    Cloud only.

    Network · enhance-image

  • Detect and erase text or common icons, then fill the area

    Cloud only.

    Network · erase-image

  • Score image quality and aesthetics

    Cloud only.

    Network · evaluate-image-quality

  • Detect faces and apply a mosaic to them

    Cloud only.

    Network · face-blur-image

  • Flip an image horizontally or vertically

    Cloud only.

    Network · flip-image

  • Blur an image by a set strength

    Cloud only.

    Network · gaussian-blur-image

  • Read printed Chinese and English text with positions and confidence

    Cloud only.

    Network · image-ocr

  • Make a negative of the image

    Cloud only.

    Network · invert-image

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. 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-onlyNo read-only mode. Review each command before it runs.
Talks toMediaKit cloud API on Volcengine (Cloud mode: your media or its URL, plus your API key)
Sign-in and keysREADME: 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-image do?

It lets Claude process images through mediakit-cli. It can resize, crop, rotate, flip, compress, sharpen, blur, add watermarks, remove backgrounds, read text with OCR, score quality and hide faces.

How do I install byted-mediakit-image?

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.

slim-image or compress-image?

SKILL.md picks slim-image when you stress keeping quality and give no size, quality value or format. It picks compress-image when you give quality, max size or output format, ask for a format change, or accept lossy PNG. If it cannot tell, it asks.

Does it run locally?

No. All 21 image tools are marked Cloud in SKILL.md.

Is it safe?

Installing the skill copies files only: the folder holds SKILL.md, a LICENSE and 22 reference files, with no scripts. Using it makes Claude run mediakit-cli in your shell, and every image tool is Cloud, so your images go to MediaKit's cloud and your API key is used. Review each command 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-image

volcengine/mediakit-cliskills.sh

Sources

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

Show all 3
  1. byted-mediakit-shared SKILL.md · github.com
  2. volcengine/mediakit-cli README · github.com
  3. byted-mediakit-image SKILL.md · github.com

Updated Nov 2, 2026.