Media Converter

Detect media file types via magic bytes and correct extensions.

26|5|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/kunwl123456/zeroclaw-skills-collection --skill media-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Media Converter
Source: https://github.com/kunwl123456/zeroclaw-skills-collection/tree/main/media-converter
Command: npx skills add https://github.com/kunwl123456/zeroclaw-skills-collection --skill media-converter

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 rejection by systems like Gemini that flag application/octet-stream types. It also provides basic conversion capabilities.

Core Features & Use Cases

  • MIME Type Detection: Identifies file types based on magic bytes.
  • Extension Fixing: Renames files to match their detected MIME type.
  • Basic Conversion: Converts GIFs to PNGs (using the first frame).
  • Use Case: You have a file named image.bin that is actually a GIF. This skill can detect it's a GIF and rename it to image.gif, or convert it to image.png.

Quick Start

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

Frequently Asked Questions about Media Converter

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

FAQPage Schema
How do I fix incorrect media file extensions rejected by platforms like Gemini?

This skill fixes incorrect media file extensions by detecting actual file types using magic byte signatures and renaming files accordingly, preventing system rejections caused by generic application/octet-stream MIME types.

How do I detect the real MIME type of an unknown image or video file?

To detect the real MIME type of an unknown media file, this skill analyzes its magic byte signatures, identifying the true format regardless of the current file extension.

Can I convert a GIF to a PNG file?

Yes, you can convert a GIF to a PNG file. This skill uses the Jimp library to extract the first frame of the GIF and saves it as a PNG image.

Do I need Node.js and the Jimp library to run the media converter?

Yes, you need Node.js and the Jimp library to run this media converter, as Node.js provides the runtime and Jimp handles the underlying image manipulation and conversion logic.

What are the limitations of using magic bytes for file type detection?

A limitation of using magic bytes for file type detection is that it only reads file headers to determine format, meaning it cannot process corrupted headers or extract subsequent frames from animated GIFs.