# File Conversion

> Convert files between formats — PDF to Word, HEIC to JPG, MP4 to MP3, CSV to JSON, EPUB to MOBI, and 999 total routes across images, video, audio, documents, data, fonts, ebooks, and archives. Free via changethisfile.com, no API key or signup. Use when the user needs a file converted to a different format.

Source: https://skillsagentes.com/skills/wshobson/agents/file-conversion
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 2 meses
Context cost: 77 tok installed, 741 tok once triggered, 1.8k tok with every bundled file
Bundle: 2 files, 7 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill file-conversion --agent claude-code
```

## What it does

- Convierte archivos entre formatos (PDF↔Word, HEIC↔JPG, MP4↔MP3, CSV↔JSON, EPUB↔MOBI, etc.) usando el servicio gratuito changethisfile.com
- Usa las herramientas MCP changethisfile:convert_file y list_conversions si están disponibles
- Como alternativa, ejecuta scripts/convert.sh que llama al endpoint MCP alojado vía HTTPS
- Permite convertir archivos remotos por URL con una sola llamada curl sin descargar/reubicar localmente
- Consulta list_conversions para descubrir rutas de conversión soportadas antes de asumir una exótica

## Use it when

- El usuario necesita convertir un archivo a otro formato
- La conversión es entre imágenes, video, audio, documentos, datos, fuentes, ebooks o archivos comprimidos
- El archivo pesa menos de 25 MB (límite del camino gratuito)

## What triggers it

- "Convierte este PDF a Word"
- "Necesito pasar este HEIC a JPG"
- "Convierte este MP4 a MP3"
- "Transforma este CSV en JSON"
- "Pasa este EPUB a MOBI"

## Before you install

- Requiere acceso HTTPS de salida a changethisfile.com; no hace falta cuenta ni API key salvo para archivos de más de 25 MB.
- Needs on PATH: curl, sed
- Environment: B64_FILE, BASENAME, CHANGETHISFILE_MCP_URL, DOWNLOAD_URL, ENDPOINT, HTTP_CODE, REQ_FILE, RESP_FILE, SAFE_FN, SIZE, TARGET

## Files

- SKILL.md — 3 KB
- scripts/convert.sh — 4 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# File Conversion (ChangeThisFile)

Convert files between 999 conversion routes using the free ChangeThisFile service. No account or API key required. Conversions run server-side (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript); files are deleted within 24 hours.

## Decision order

1. **If ChangeThisFile MCP tools are available** (`changethisfile:convert_file`, `changethisfile:list_conversions`) — use them directly. `convert_file` takes `source_url` OR `base64_content` + `source_format`, plus `target_format`, and returns a temporary download URL.
2. **Otherwise, use the bundled script** (requires network access to changethisfile.com):

```bash
scripts/convert.sh <input-file> <target-format> [output-file]
# e.g. scripts/convert.sh report.docx pdf
# prints the output file path on success
```

The script path is relative to this skill's directory. It base64-encodes the file, calls the hosted MCP endpoint over plain HTTPS, downloads the result, and writes it next to the input (or to `[output-file]`).

3. **Remote file (you have a URL, not a local file)** — skip the download/re-upload; one curl does it:

```bash
curl -sS -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_file","arguments":{"source_url":"<FILE_URL>","target_format":"pdf"}}}'
```

The response text contains a download URL — fetch it with `curl -o <output>`.

## Discovering supported routes

Ask before guessing if a conversion is exotic:

```bash
curl -sS -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_conversions","arguments":{"source_format":"docx"}}}'
```

Omit `source_format` for a grouped summary of all 999 routes.

## Limits and errors

- Max input: **25 MB** (free path). Larger files: get a free API key (1,000 conversions/month) at https://changethisfile.com/docs/authentication and use `POST /v1/convert`.
- Rate limit: **5 conversions/minute per IP**. On "Rate limit exceeded", wait 60 seconds and retry once.
- "Unsupported conversion: X→Y" errors list the valid targets for that source format.
- Download URLs expire after 1 hour — download immediately, then work with the local file.

## Environment notes

- Needs outbound HTTPS to `changethisfile.com`. On claude.ai, the code-execution sandbox restricts egress by default — prefer the MCP connector there, or the user can allow the domain under Settings → Capabilities.
- Full docs: https://changethisfile.com/docs/mcp

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/file-conversion