Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
Convert images, video, audio, PDFs and documents locally with the convt CLI.
Install Convt
$ npx skills add opencoredev/convt --skill convt -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install opencoredev/convt convt --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/opencoredev/convt.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/convt-cli .claude/skills/convt && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "convt" agent skill from https://github.com/opencoredev/convt/tree/main/crates/convt-cli into .claude/skills/convt/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convt", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/opencoredev/convt/tree/main/crates/convt-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add opencoredev/convt --skill convt -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install opencoredev/convt convt --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/opencoredev/convt.git skills-src && mkdir -p .agents/skills && cp -r skills-src/crates/convt-cli .agents/skills/convt && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "convt" agent skill from https://github.com/opencoredev/convt/tree/main/crates/convt-cli into .agents/skills/convt/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convt", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add opencoredev/convt --skill convt -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install opencoredev/convt convt --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/opencoredev/convt.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/crates/convt-cli .cursor/skills/convt && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "convt" agent skill from https://github.com/opencoredev/convt/tree/main/crates/convt-cli into .cursor/skills/convt/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convt", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/opencoredev/convt.git --path crates/convt-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add opencoredev/convt --skill convt -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install opencoredev/convt convt --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/opencoredev/convt.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/crates/convt-cli .gemini/skills/convt && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "convt" agent skill from https://github.com/opencoredev/convt/tree/main/crates/convt-cli into .gemini/skills/convt/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convt", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install opencoredev/convt convtInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add opencoredev/convt --skill convt -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/opencoredev/convt.git skills-src && mkdir -p .github/skills && cp -r skills-src/crates/convt-cli .github/skills/convt && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "convt" agent skill from https://github.com/opencoredev/convt/tree/main/crates/convt-cli into .github/skills/convt/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convt", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add opencoredev/convt --skill convt -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install opencoredev/convt convt --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/opencoredev/convt.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/crates/convt-cli .opencode/skills/convt && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "convt" agent skill from https://github.com/opencoredev/convt/tree/main/crates/convt-cli into .opencode/skills/convt/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "convt", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
convt- GitHub stars
- 286
- Token cost
- ~977 tokens
- SKILL.md length
- 452 words
- Files
- 6
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Convert images, video, audio, PDFs and documents locally with the convt CLI.
- An agent needs to convert files on the users machine without uploading them
- SKILL.md covers Install check, Convert, Commands and Formats, plus 3 more sections
- Runs Rust scripts from its folder; calls cargo
- Run a batch from a script
What it does
Convt is an agent skill from opencoredev/convt. Convert images, video, audio, PDFs and documents locally with the convt CLI. Use when an agent needs to convert files on the user's machine without uploading them, list formats or engines, or run a batch from a script.
Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files.
It sits in Documents & Office. The repository describes itself as: Convert any file with a right-click. The licence is AGPL-3.0.
When your agent uses it
- An agent needs to convert files on the users machine without uploading them
- Run a batch from a script
Example prompts
- “/convt”
What it can do on your machine
Read from SKILL.md and the folder at commit 3ff6a7f. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Rust), which the agent can run.
Shell commands in SKILL.md call:
cargo
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
convt.app
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Convt loads about 977 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 452 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from opencoredev/convt at commit 3ff6a7f, republished under its AGPL-3.0 licence (© opencoredev). 452 words, ~977 tokens.
Download SKILL.mdSave it as
.claude/skills/convt/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.- name
- convt
- description
- Convert images, video, audio, PDFs and documents locally with the convt CLI. Use when an agent needs to convert files on the user's machine without uploading them, list formats or engines, or run a batch from a script.
convt
Local file conversion. Right-click or run the CLI; files stay on disk. Nothing is uploaded. Routes through engines on this machine (FFmpeg, PDFium, LibreOffice, image, resvg, libheif). Multi-hop routes are at most three steps. A still image cannot become video or audio through a multi-hop route.
Print this file: convt --skill or convt skill.
Install check
command -v convt
convt --version
convt enginesconvt engines lists each ready backend and each unavailable one with its reason. A "no route" error usually means an engine is missing, not a bad flag. Packaged installs come from https://convt.app/download. From this repository: cargo run -p convt-cli -- … or ./target/debug/convt. A convt on PATH may be an older install.
Convert
convt <files or folders> --to <fmt> [options]--to is required unless --preset names a preset that sets to. Output lands next to each input unless --out-dir is set. With --out-dir, files found in subfolders keep their relative folder.
{{FLAGS}}
Commands
{{COMMANDS}}
Formats
Ids are what --to and convt formats use. Extensions select the input format (no content sniffing). Availability depends on convt engines; Office formats need LibreOffice or convt pack install documents. Raster-to-SVG is not offered.
{{FORMATS}}
Examples
convt photo.png --to webp
convt photos/ --to webp -r
convt lease.pdf --to png --pages 1-3
convt clip.mov --to mp4 --video-height 720
convt photo.png --to jpeg -q 60 --max-size 64 --background black
convt clip.mov --to mp4 --no-audio --video-codec hevc
convt photos/ -r --to webp -j 4 --json --out-dir out/
convt targets photo.heic
convt targets photo.heic --menu
convt formats --json
convt pack status documentsExit codes and errors
0: success (including--skill,--help, and list commands)1: a conversion failed, or the run was rejected before it started (no--to, unknown format, nothing to convert, license)2: usage error from the parser (unknown flag, bad value)130: cancelled (SIGINT; a second interrupt exits immediately)
--json prints one event per line on stdout: started, progress, done, failed, then summary. A failed event has a stable kind: unsupported_input, no_route, invalid_option, engine_missing, engine_failed, output_exists, cancelled, io.
Folder inputs skip files that cannot reach the target (or already are it). Files named directly always run, so their errors show.
Show full SKILL.md (172 more words)Show less
Tips for agents
- Non-interactive: pass every option on the command line. The CLI does not prompt.
- Prefer
--jsonwhen parsing progress. Humaninput -> outputlines go to stderr unless--json. - Outputs never overwrite existing files; a taken name gets a numbered suffix. Use
--out-dirto keep results apart from the inputs. - Discover before converting:
convt engines,convt formats,convt targets path/to/file. formats,targets,engines,presetsand--skillnever need a license. Only conversions do. Source builds skip the license check by default; packaged builds start a 7-day trial on the first conversion.- In an enforced build,
convt license activatereads the key from stdin when KEY is omitted. Do not put a license key in a shared command line. convt pack install documentsis the only pack command that may use the network.pack statusis offline.- Presets are TOML (
to,quality,max_size, …) under the config presets directory, or a path to a.tomlfile. List them withconvt presets. PointCONVT_CONFIG_DIRat a private directory instead of the user's real presets.
© opencoredev, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 5 other files in crates/convt-cli of opencoredev/convt.
- SKILL.md
- Cargo.toml
- src/main.rs
- src/skill.rs
- tests/conversions.rs
- tests/license.rs
Open the folder on GitHubat commit 3ff6a7f
Compare with similar skills
Convt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Convt this skillopencoredev/convt | 286 | — | ~977 | Automated safety check: Pass | AGPL-3.0 | |
| Markdown Article FormatterJimLiu/baoyu-skills | 27k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Obsidian MarkdownAtmosphere/atmosphere | 3.8k | 20 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| DOCXrvdbreemen/OTGW-firmware | 207 | 33 repos | ~4.3k | Automated safety check: Pass | Proprietary | |
| Word Document Reader and WriterHKUDS/DeepTutor | 41k | — | ~2.5k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
DOCX
rvdbreemen/OTGW-firmware
A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).
Word Document Reader and Writer
HKUDS/DeepTutor
Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.
Crossposting
wasp-lang/wasp
Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.
More from opencoredev/convt
Test Convt CLI
opencoredev/convt
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.
Test Convt Desktop
opencoredev/convt
Run the headless window tests for the convt GPUI desktop app (crates/convt-app), and build, launch and screenshot it under Xvfb or natively on macOS and Windows.
Test Convt Web
opencoredev/convt
Run and verify the convt.app website (apps/web, TanStack Start on Cloudflare Workers) and its billing Worker (apps/billing) locally, with Postgres, Mailpit, the OAuth mock and the Polar and Resend…
Test Convt Server
opencoredev/convt
Run and verify the convt jobs API, Postgres queue, object storage, sandbox worker and metering locally.
Related
Categories
Questions about Convt
What does Convt do?
Convert images, video, audio, PDFs and documents locally with the convt CLI. Convt is an agent skill from opencoredev/convt. Convert images, video, audio, PDFs and documents locally with the convt CLI.
When should I use Convt?
Convt fits situations like: an agent needs to convert files on the users machine without uploading them; run a batch from a script.
How do I install Convt in Claude Code?
Run `npx skills add opencoredev/convt --skill convt -a claude-code`. Or copy the skill folder (crates/convt-cli in opencoredev/convt) into .claude/skills/convt in your project. Claude Code loads it when a task matches its description.
How do I install Convt in Codex?
Run `npx skills add opencoredev/convt --skill convt -a codex`. Or copy the skill folder (crates/convt-cli in opencoredev/convt) into .agents/skills/convt in your project. Codex loads it when a task matches its description.
Can I use Convt in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add opencoredev/convt --skill convt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/convt, .gemini/skills/convt, .github/skills/convt and .opencode/skills/convt in your project.
What does Convt need to run?
Going by SKILL.md and its folder, Convt needs Rust for the scripts in its folder and the command-line tools its instructions call (cargo).
Does Convt access the network?
SKILL.md names 1 domain. As links in the text: convt.app. This is read from the text; nothing was executed.
Is Convt safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Convt use?
Convt is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Convt use?
About 977 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Convt?
Skills that share tags, products or a category with Convt: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Convt?
opencoredev (a GitHub organization) maintains it in opencoredev/convt, which has 286 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.
Source: opencoredev/convt on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.