# Format Converter > Convert files between formats. Use for Document conversion, Image format conversion, and Audio/Video format conversion. Use when this capability is needed. - Skill: `tomevault-io/format-converter` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/format-converter` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/format-converter/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/format-converter --- # File Format Conversion ## Execution Environment Run format conversion commands in the local VM environment by default. Do not perform conversion work on local macOS or a cloud VM unless the user explicitly asks for that environment. ## Workflow Decision | Task | Tool | Reference | | ----------------------- | --------------- | ----------------------------------------------------- | | Document conversion | pandoc | [document-convert.md](references/document-convert.md) | | Image format conversion | Python (Pillow) | [image-convert.md](references/image-convert.md) | | Audio/video conversion | ffmpeg | [av-convert.md](references/av-convert.md) | ## Quick Reference ### Document Conversion Read [`references/document-convert.md`](references/document-convert.md) for detailed workflow. Key points: - PDF generation: ALWAYS use `--pdf-engine=weasyprint` (lightweight, auto-installed) - Pandoc supports markdown, HTML, PDF, DOCX, LaTeX, and many more formats ```bash # PDF from markdown pandoc input.md -o output.pdf --pdf-engine=weasyprint # DOCX from HTML pandoc input.html -o output.docx ``` ### Image Conversion Read [`references/image-convert.md`](references/image-convert.md) for detailed workflow. Key points: - Use `Image.LANCZOS` for any resize operation (prevents color banding/aliasing) - Convert RGBA to RGB before saving as JPEG - Preserve EXIF metadata when possible ```bash # Dependencies apt install python3-pil python3-pillow-heif ``` ### Audio/Video Conversion Read [`references/av-convert.md`](references/av-convert.md) for detailed workflow. Key points: - Use `-c copy` when only changing container format (fast, lossless) - Use `flags=lanczos` in scale filters for best quality - Use `-crf` for quality-based encoding Check `ffmpeg` available before using it. --- > Source: [AFK-surf/OpenBridge](https://github.com/AFK-surf/OpenBridge) — distributed by [TomeVault](https://tomevault.io).