Media Converter Skill

Detect media file types via magic bytes and correct extensions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/WangK0221/OpenClaw_Shrimp --skill media-converter-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Media Converter Skill
Source: https://github.com/WangK0221/OpenClaw_Shrimp/tree/main/skills/media-converter
Command: npx skills add https://github.com/WangK0221/OpenClaw_Shrimp --skill media-converter-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jimp, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures media files have correct extensions, preventing compatibility issues with systems like Gemini that reject generic application/octet-stream types.

Core Features & Use Cases

  • Magic Byte Detection: Identifies the true media type of a file based on its internal data.
  • Automatic Extension Correction: Renames files to match their detected media type.
  • Basic Conversion: Includes a placeholder for future media conversion capabilities (e.g., GIF to PNG).
  • Use Case: You have a file named image.bin that is actually a GIF. This skill will detect it's a GIF and rename it to image.gif.

Quick Start

Use the media-converter skill to fix the file extension for the file located at /tmp/unknown.bin.

Frequently Asked Questions about Media Converter Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a media file with the wrong extension?

To fix a media file extension, detect the file's true media type using magic byte signatures and rename the file to match. This ensures correct format identification for downstream compatibility.

Why does my system reject application/octet-stream media files?

Systems like Gemini reject application/octet-stream types because they cannot verify media compatibility. Correcting file extensions based on internal magic bytes ensures systems recognize the actual image or video format.

Can I use magic byte detection to identify unknown image and video formats?

Yes, you can identify unknown image and video formats using magic byte detection. This process reads internal file data signatures to accurately determine the true MIME type regardless of the current file extension.

What's the best way to correct file extensions for multiple media files?

The best way to correct file extensions is to scan media files using magic byte detection and automatically rename them to match their detected MIME type, preventing downstream application compatibility issues.

Do I need file system access to detect MIME types and rename files?

Yes, you need file system access to read internal file data for magic byte detection and to execute the automatic extension correction by renaming the media files on disk.

Does this media converter support converting GIF to PNG?

No, converting GIF to PNG is not currently supported. The skill includes a placeholder for future media conversion capabilities, but currently focuses only on detecting and correcting file extensions.