⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

test-convt-cli

@opencoredev⭐ 293 stars

Test convt conversions end to end through the `convt` CLI, the engines in convt-engines, routing in convt-core, and the Linux file-manager menus in integrations/linux. Use when changing an engine, a format, the registry, the CLI, or install.py, or when asked to reproduce a conversion bug or prove a conversion works.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 293 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

convt

Local file conversion for your own machine. Right-click a file, pick a format, and convt writes the result next to the original. Images, video, audio, PDFs and documents stay on disk: nothing is uploaded.

  • 40 formats, routed through native engines (FFmpeg, PDFium, LibreOffice, image, resvg)
  • A desktop app built with GPUI, with a Finder menu on macOS and file manager menus on Linux. The Windows Explorer menu is built (crates/convt-shell) but not yet in the release installer
  • The convt CLI, shipped in the same install
  • Multi-hop routes of at most three steps when no engine can convert directly
  • Optional document pack for Word, Excel and PowerPoint, installed only when you ask
  • A paid cloud API and TypeScript SDK for converting files on convt's servers
  • Accounts, checkout and downloads on convt.app

Install

macOS (Apple silicon) with Homebrew:

brew tap opencoredev/convt https://github.com/opencoredev/convt
brew install --cask convt

That installs the signed app and puts the convt CLI on your PATH. Download the app from convt.app/download for a disk image, Windows MSI, or Linux packages. There is no Linux Homebrew formula yet; use the .deb, .rpm or AppImage. Packaged builds start a 7-day trial on the first conversion.

To build from source:

bun run setup
cargo run -p convt-cli -- photo.png --to webp

bun run setup installs system packages (asks for sudo on Linux and macOS), the Rust toolchain, Bun dependencies and PDFium. On Windows run scripts/setup-windows.ps1 in PowerShell. Ordinary source builds are unrestricted.

Usage

convt clip.mov --to mp4
convt photos/ --to webp -r
convt lease.pdf --to png --pages 1-3

From a checkout, prefix those with cargo run -p convt-cli --. Output lands next to each input unless you pass --out-dir.

Engines

convt registers whatever can run on this machine and picks a route:

  • FFmpeg for video and audio (MP4, MOV, WebM, MKV, AVI, MP3, WAV, FLAC, AAC, M4A, OGG, Opus)
  • LibreOffice for Word, Excel, PowerPoint and their open formats, and for saving any of them as PDF
  • PDFium to render PDF pages to PNG or JPEG
  • image and resvg for photos and SVG (JPEG, PNG, WebP, AVIF, GIF, TIFF, BMP, ICO, TGA, PPM, QOI, OpenEXR)
  • libheif, or sips on macOS, for HEIC

Office files need LibreOffice on PATH. Released Windows builds can also run convt pack install documents, which downloads the pinned pack from the GitHub release and verifies its checksum. Ordinary source builds need a system LibreOffice, or an explicit --source and --sha256. The engines never start that download themselves.

CLI

convt engines              # backends available here
convt targets photo.heic   # formats this file can reach
convt targets photo.heic --menu
convt formats
convt presets
convt pack status documents
convt --skill              # SKILL.md for AI coding agents (also: convt skill)

convt --help lists quality, size, pages, DPI, video and job flags. See AGENTS.md for the rest of the commands in this repo.

Cloud API

The cloud API converts files on convt's servers for a paid plan. You upload a file, start a job, and download the result. @convt/sdk wraps those calls in TypeScript but is not on npm yet; see the API docs for keys, the host to call and the full reference. The API is crates/convt-server, and conversions run in sandboxed crates/convt-worker processes using the same engines as the app.

Documentation

  • convt.app: product site, pricing and sign-in
  • Download: desktop builds and matching source archives
  • Formats: every format and the targets it can reach
  • API docs: the cloud API, the SDK and the API reference
  • AGENTS.md: repo layout, conventions, and how to check, test and build

License

convt is open source under the GNU AGPL v3. The signed desktop builds, convt Cloud and the API are paid. "convt" and the convt logo are trademarks and are not covered by the code license.

Sponsors

Want your logo here? Become a sponsor →

Star History

// HOW IT'S BUILT

KEY FILES

.agents/skills/test-convt-cli/SKILL.mdREADME.md

// REPO STATS

293 stars