Skip to content

Local File Conversion

Convert images, audio, video, documents and data between formats using tools on your own machine.

Repository
wshobson/agents
Stars
42,095
Licence
MIT
Files
1 file

What it does

When you ask the agent to convert a file (for example a video to MP3, a PNG to JPEG, Markdown to Word, or CSV to JSON), it checks the file's real format, finds conversion tools already installed on your computer, and runs them locally. It keeps your original file untouched, writes the result to a new folder, and reopens the output to confirm it worked. It is instructed not to upload files to online conversion services.

Great for

  • People who need to convert media or documents and want the work done on their own machine
  • Developers converting data files like CSV to JSON with a clear schema
  • Users who have FFmpeg, ImageMagick, Pandoc or LibreOffice installed and want the agent to pick the right one

Skip it if

  • Scanned PDFs or encrypted/damaged files, because the skill says OCR tooling is needed and some inputs have no supported route; it explicitly tells the agent to stop rather than guess
  • Sensitive files where you need guarantees beyond the skill's instructions, because it runs local commands and the agent could still make mistakes
  • Lossless PDF-to-editable-Word conversion, which the skill states is not a general lossless process

Try asking

  • “Convert the audio from this MP4 recording into an MP3 file”
  • “Turn this PNG into a JPEG with a white background”
  • “Convert my Markdown notes into a DOCX document”
  • “Change this CSV of customer data into a JSON file”
Step-by-step guide: how to use Local File ConversionInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    file-conversion.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip file-conversion.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip file-conversion.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Name the input file and the exact output format you want, and state any quality or transparency requirements
  • Make sure the needed tools are installed beforehand; the skill reports missing tools rather than always installing them
  • Check the output yourself for layout, quality, and data accuracy, especially for Office-to-PDF and Markdown-to-DOCX conversions

What's inside

  • SKILL.md

Redistributed unmodified from wshobson/agents under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.