@conversiontools agent skills
$git clone https://github.com/conversiontools/agent-skillsInstalls into the current project.
Install agent-skills by running `git clone https://github.com/conversiontools/agent-skills`, then use it for the current task and follow its documentation at https://github.com/conversiontools/agent-skills.
| 1 | # `conversiontools/agent-skills` |
| 2 | |
| 3 | **[Conversion Tools](https://conversiontools.io) agent skills** - convert 140+ file formats directly from AI agents, or build a custom converter from a plain-language description when none fits. |
| 4 | |
| 5 | Two surfaces, same backend: the **`ctio` CLI** for terminal-first agents, and the hosted **MCP server** for zero-install / web-based agents. The skill teaches your agent to pick the right one. |
| 6 | |
| 7 | One repo, every agent. Full per-agent setup is at <https://conversiontools.io/docs/agents>. |
| 8 | |
| 9 | ## Installation |
| 10 | |
| 11 | ### Claude Code |
| 12 | |
| 13 | ```bash |
| 14 | claude plugin marketplace add conversiontools/agent-skills |
| 15 | claude plugin install conversiontools@conversiontools-skills |
| 16 | ``` |
| 17 | |
| 18 | Restart Claude Code after installation. The MCP server connects automatically. |
| 19 | |
| 20 | ### Cursor |
| 21 | |
| 22 | ```bash |
| 23 | /add-plugin conversiontools |
| 24 | ``` |
| 25 | |
| 26 | Or add the repo as a plugin source, then install `conversiontools` from the plugins browser. |
| 27 | |
| 28 | ### OpenAI Codex |
| 29 | |
| 30 | ```bash |
| 31 | codex plugin marketplace add conversiontools/agent-skills |
| 32 | ``` |
| 33 | |
| 34 | Start Codex, open the plugins browser with `/plugins`, and install the `conversiontools` plugin. |
| 35 | |
| 36 | ### Grok Build |
| 37 | |
| 38 | Once listed in the Grok marketplace, run `/marketplace` inside Grok Build and install `conversiontools`. In the meantime, add the MCP server with `grok mcp add conversiontools --url https://mcp.conversiontools.io/mcp`. |
| 39 | |
| 40 | ### Gemini CLI |
| 41 | |
| 42 | ```bash |
| 43 | gemini extensions install https://github.com/conversiontools/agent-skills |
| 44 | ``` |
| 45 | |
| 46 | Update later with `gemini extensions update conversiontools`. (The standalone [conversiontools/gemini-extension](https://github.com/conversiontools/gemini-extension) repo also works and stays current.) |
| 47 | |
| 48 | ### ctio CLI (best for shell-driven workflows) |
| 49 | |
| 50 | Single-binary CLI, no Node/Bun runtime required. Pipes nicely with `jq`, handles arbitrarily large files via streaming. |
| 51 | |
| 52 | **Windows (scoop):** |
| 53 | |
| 54 | ```bash |
| 55 | scoop bucket add conversiontools https://github.com/conversiontools/scoop-bucket |
| 56 | scoop install ctio |
| 57 | ``` |
| 58 | |
| 59 | **macOS / Linux:** download from <https://github.com/conversiontools/ctio/releases> - one-line install commands for each platform are in the [ctio docs](https://conversiontools.io/docs/ctio). |
| 60 | |
| 61 | ### Any MCP client |
| 62 | |
| 63 | Connect to the hosted MCP server: |
| 64 | |
| 65 | ``` |
| 66 | https://mcp.conversiontools.io/mcp |
| 67 | ``` |
| 68 | |
| 69 | --- |
| 70 | |
| 71 | | Skill | Description | |
| 72 | |-------|-------------| |
| 73 | | [convert](https://github.com/conversiontools/agent-skills/tree/main/skills/convert) | Convert files between 140+ formats using Conversion Tools. Two surfaces - the `ctio` CLI (preferred when shell access is available) and the hosted MCP server (zero-install). Supports documents, data formats (incl. Parquet), images (incl. JXL), audio, video, e-books, OCR, AI extraction, text-to-speech (TTS), speech-to-text (STT), subtitles (SRT, VTT, ASS), and website screenshots. Plus build a custom converter from a plain-language description (AI Studio) when no standard one fits. | |
| 74 | |
| 75 | ## Supported Conversions |
| 76 | |
| 77 | - **Documents**: Word, PowerPoint, Excel, Markdown, ODS to/from PDF, HTML, Text, LaTeX |
| 78 | - **Data**: JSON, CSV, XML, YAML, Parquet, JSONL, BSON, Excel - with validators and formatters |
| 79 | - **Images**: PNG, JPG, WebP, AVIF, HEIC, JXL (JPEG XL), SVG, BMP, TIFF, GIF |
| 80 | - **PDF**: Extract to Word, Excel, CSV, Text, HTML, Images (JPG, PNG, SVG, TIFF), EPUB |
| 81 | - **Audio**: MP3, WAV, FLAC - plus AI text-to-speech and speech-to-text |
| 82 | - **Video**: MP4, MOV, MKV, AVI - plus audio extraction |
| 83 | - **E-books**: EPUB, MOBI, AZW, AZW3, FB2, FBZ, PDF |
| 84 | - **OCR**: Extract text from images and scanned PDFs - output as Text or searchable PDF |
| 85 | - **AI-powered**: Smart extraction from complex documents, subtitle translation, TTS, STT |
| 86 | - **Subtitles**: SRT, VTT, ASS - bidirectional conversions |
| 87 | - **Web**: Website screenshots to PDF, JPG, PNG |
| 88 | - **Custom (AI Studio)**: describe a transformation in plain language and have a reusable converter built, run, and returned - for when no standard converter fits |
| 89 | |
| 90 | ## Authentication |
| 91 | |
| 92 | For the MCP server, you'll be prompted to authenticate via OAuth in your browser on first use. For the `ctio` CLI, run `ctio auth login` once and paste an API token from [conversiontools.io/profile](https://conversiontools.io/profile). Free accounts get 100 conversions per month (10 per day). Paid plans available at [conversiontools.io/pricing](https://conversiontools.io/pricing). |
| 93 | |
| 94 | ## Links |
| 95 | |
| 96 | - [All agent integrations](https://conversiontools.io/docs/agents) |
| 97 | - [ctio CLI docs](https://conversiontools.io/docs/ctio) |
| 98 | - [MCP server docs](https://conversiontools.io/docs/mcp) |
| 99 | - [Pricing](https://conversiontools.io/pricing) |
| 100 | - [Support](https://conversiontools.io/contact) |
| 101 | |
| 102 | ## License |
| 103 | |
| 104 | MIT |