# File Conversion

> Converts images, audio, video, documents and data with the tools on your machine, keeps your originals and checks every result.

File Conversion is a skill from Seth Hobson's wshobson/agents collection that teaches your agent to convert local files between common formats with tools already installed on your machine. It inspects the source, picks a supported route, writes the result to a fresh folder without touching the original, and reopens the output to check it. Files stay local: it never uploads them to a conversion service.

What you can do with it
- Pull the audio out of a video, or change a video's container or codec, with FFmpeg and FFprobe
- Change image formats with ImageMagick, handling transparency, orientation, colour profiles and multi-frame files
- Turn Markdown, HTML or DOCX into other document formats with Pandoc
- Export Office documents to PDF with LibreOffice
- Convert CSV to JSON with Python's standard library, keeping values such as leading zeros intact

How it works
- Checks the real file type rather than trusting the extension, and which tools, codecs and formats your machine supports
- Writes to a new output folder and never overwrites the input or an earlier result
- Verifies the output: dimensions and frames for images, streams and duration for media, pages and tables for documents, row counts and values for data
- Stops and explains when a route isn't supported, instead of renaming a file or falling back to a hosted service

Good to know
- It brings guidance, not the converters: you need FFmpeg, ImageMagick 7, Pandoc, LibreOffice or Python 3 for the formats you use
- No account or API key
- PDF to editable Word isn't guaranteed, and scanned PDFs need local OCR tools
- Documents with external links or macros are converted only with network access blocked and macros disabled
- In Claude Code, run /plugin marketplace add wshobson/agents, then /plugin install file-conversion@claude-code-workflows
- A community project by Seth Hobson, MIT licensed

- Type: Skill
- Made by: wshobson
- Category: Media
- Formats: Skills
- Version: a923308
- Website: https://github.com/wshobson/agents/tree/main/plugins/file-conversion
- Source: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion
- Page: https://pluginboard.ai/skills/file-conversion

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the file-conversion folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Claude

In Claude (web or desktop): Download the file-conversion folder and zip the folder itself, then upload it in Customize → Skills.

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Gemini

In Gemini: Download the file-conversion folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### GitHub Copilot

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.copilot/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Cursor

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.cursor/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Claude Code

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.claude/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

Or as a Claude Code plugin:

```text
/plugin marketplace add wshobson/agents
/plugin install file-conversion@claude-code-workflows
```

### Codex

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.agents/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Antigravity

In Antigravity: Copy the file-conversion folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Gemini CLI

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.gemini/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Replit

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion .agents/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### OpenClaw

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.openclaw/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### OpenCode

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.config/opencode/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

### Hermes Agent

Run in your terminal:

```shell
npx -y degit wshobson/agents/plugins/file-conversion/skills/file-conversion ~/.hermes/skills/file-conversion
```

View the folder on GitHub: https://github.com/wshobson/agents/tree/HEAD/plugins/file-conversion/skills/file-conversion

---
From Pluginboard (https://pluginboard.ai).
