# FlyingMouse Format Converter

Converts images, PDFs, audio and video offline with a local CLI.

- Repository: https://github.com/LaoFeng-mouse/flyingmouse-format (6986 stars)
- Category: Documents
- License: see repository
- Last updated: 2026-10-14
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add LaoFeng-mouse/flyingmouse-format --skill flyingmouse-format -g -a claude-code -y`
Codex: `npx skills add LaoFeng-mouse/flyingmouse-format --skill flyingmouse-format -g -a codex -y`
Cursor: `npx skills add LaoFeng-mouse/flyingmouse-format --skill flyingmouse-format -g -a cursor -y`
Gemini CLI: `npx skills add LaoFeng-mouse/flyingmouse-format --skill flyingmouse-format -g -a gemini-cli -y`

## Description

Use FlyingMouse Format's local offline CLI to inspect supported conversions and convert images, text, documents, spreadsheets, presentations, PDFs, subtitles, archives, audio, and video. Trigger when a user asks to convert file formats, extract text with OCR, merge images into PDF, merge PDFs, inspect available target formats, or automate these operations from an agent.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# FlyingMouse Format

Use the bundled wrapper at `scripts/flyingmouse-format.js`. It locates the FlyingMouse Format application configured by the in-app “Connect to Agent” action and invokes its CLI.

## Workflow

1. Check available targets before an unfamiliar conversion:

   `node scripts/flyingmouse-format.js targets <file> --json`

2. Convert one or more independent files:

   `node scripts/flyingmouse-format.js convert <files...> --to <format> --output-dir <directory> --json`

3. Merge images into one PDF:

   `node scripts/flyingmouse-format.js images-to-pdf <images...> --output <result.pdf> --json`

4. Merge PDFs:

   `node scripts/flyingmouse-format.js merge-pdfs <pdfs...> --output <result.pdf> --json`

5. Inspect the connected application's engines and limits:

   `node scripts/flyingmouse-format.js capabilities --json`

   Use `toolDetails.libreoffice.status` and `toolDetails.pdfStructure` when available. Office preparation may be pending while other conversions remain available; the Lite edition omits the advanced scanned-table engine. Check runtime targets and limits before selecting a conversion, because the connected application may be an older installation.

## Conversion expectations

The rest: https://github.com/LaoFeng-mouse/flyingmouse-format/blob/HEAD/agent-skill/flyingmouse-format/SKILL.md