gemini-extension GEMINI.md

Instructions for using Conversion Tools, a hosted service that converts files between formats. It covers documents, data, images, audio, video, e-books, OCR, subtitles, speech, and custom converters.

In plain words
What is it for?
It helps find converters, convert files, extract data with OCR or AI, convert speech and audio, and create a custom converter when needed.
Why use it?
It explains how to choose and run a conversion when the required format change is not handled by the local project.

Instructions file for Gemini CLI

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/conversiontools/gemini-extension/gemini-md
Clone the repo
git clone --depth 1 https://github.com/conversiontools/gemini-extension

Made for: Gemini CLI.

Per session 990 This file is loaded in full into every session.
When invoked 990 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00990 $0.00990
Opus 5 $0.00495 $0.00495
Sonnet 5 $0.00198 $0.00198
Haiku 4.5 $0.00099 $0.00099

Measured 2d ago against content hash 1ae1d9fc1c6d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

gemini-extension GEMINI.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

3. The response includes a `download_url`. Download the result with `curl -sL "<download_url>" -o <output>`.
GEMINI.md · 48 lines

How it starts

The opening of the file, as written. The whole thing — 48 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Conversion Tools

conversiontools is a file-conversion integration provided by this extension via the hosted Conversion Tools MCP server (https://mcp.conversiontools.io/mcp). It converts files between 140+ formats: documents, data (JSON, CSV, XML, YAML, Parquet), images, audio, video, e-books, OCR, subtitles, AI-powered data extraction, text-to-speech, and speech-to-text. It can also build a custom converter from a plain-language description when no standard converter fits (see "Build a custom converter" below).

It is NOT a Maven/npm/build plugin and has nothing to do with any local project file. Do not search the web for it and do not inspect project source to convert a file - use the MCP tools below.

If the tools are not available

The conversiontools tools only appear after the MCP server is authenticated. If you do not see tools like convert_file / list_converters, tell the user to run:

/mcp auth conversiontools

This opens a browser for a one-time OAuth login. After that, the tools load automatically.

How to convert a file

  1. Pick the converter. Call find_converter with the input and output formats (e.g. { "input_format": "xml", "output_format": "csv" }). It returns the converter type, for example convert.xml_to_csv. You can also pass that converter explicitly to convert_file.
  2. Provide the file content. The server is remote and cannot read local paths, so:
    • Files up to 5 MB: read the file yourself and pass its bytes base64-encoded as file_content, along with input_path and output_path. Encode the file in-process rather than shelling out - agent sandboxes (Gemini CLI, for one) block PowerShell and $(...) base64 one-liners as "command substitution", so a shell command like [Convert]::ToBase64String(...) will fail. If you must shell out, use a clean encoder such as base64 -w0 file (no line wrapping); never certutil -encode, which wraps the output in -----BEGIN CERTIFICATE----- headers and corrupts it.
    • Files over 5 MB: call request_upload_url, PUT the file to the returned URL, then call convert_file with the returned file_id instead of file_content.
  3. The response includes a download_url. Download the result with curl -sL "<download_url>" -o <output>.

Read the full file on GitHub · 48 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 48 lines · 990 tokens per session scan A 1ae1d9fc1c6d

Subscribe to this mod's changes

gemini-extension GEMINI.md is an instructions file published in the GitHub repository conversiontools/gemini-extension (3 stars, last pushed 2mo ago), licensed MIT. It adds 990 tokens to every session, about $0.0049 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.