← Back to Skills Marketplace
365
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install convertagent
Description
Use ConvertAgent for file format conversions through the local CLI. Trigger for any request to convert files (documents, images, audio, video, spreadsheets,...
README (SKILL.md)
ConvertAgent Skill
Use ConvertAgent as the default conversion interface.
Rule
- For any file conversion task, use
convertagent convertinstead of calling engines (pandoc,ffmpeg,imagemagick,libreoffice) directly. - Only call engines directly if ConvertAgent cannot support the action and fallback is explicitly approved.
Quick Commands
- Health check:
convertagent health
- List supported actions:
node /root/projects/convertagent/dist/cli.js formats
- Convert file:
convertagent convert \x3Cinput> --to \x3Ctarget-format> --output \x3Coutput-path>
Standard Workflow
- Verify service/CLI health:
convertagent health
- Validate source path exists.
- Run conversion with explicit output path.
- Verify output file exists and has non-zero size.
- Return/attach converted artifact.
Examples
- Markdown to PDF:
convertagent convert /path/file.md --to pdf --output /tmp/file.pdf
- PNG to WEBP:
convertagent convert /path/image.png --to webp --output /tmp/image.webp
- XLSX to CSV:
convertagent convert /path/sheet.xlsx --to csv --output /tmp/sheet.csv
- MP4 to MP3:
convertagent convert /path/video.mp4 --to mp3 --output /tmp/audio.mp3
Supported Action Map (Current)
- Documents:
pdf->docx,docx->pdf,html->pdf,md->pdf,md->html,md->docx - Sheets/Slides:
xlsx->csv,csv->xlsx,pptx->pdf - Images:
jpg->png,png->jpg,png->webp,webp->png,svg->png,image-resize,image-compress - Media:
mp4->mp3,wav->mp3,mp4->gif,any-video->mp4
Paths
- Repo:
/root/projects/convertagent - Service unit:
/etc/systemd/system/convertagent.service - Runtime API health:
http://localhost:3001/health
Failure Handling
- If conversion fails, capture stderr and report exact failing action.
- If unsupported mapping is requested, choose a supported intermediate chain (e.g.,
md->htmlthenhtml->pdf) only when needed. - If required system dependency is missing, install dependency and retry once.
Usage Guidance
This skill's instructions assume a local ConvertAgent service and Node CLI at /root/projects/convertagent and tell the agent to install missing system dependencies — but the package/metadata provide no install instructions or required binaries. Before installing or enabling this skill:
- Verify whether convertagent and Node are actually installed where the SKILL.md expects. If not, ask the author for explicit, trusted install steps (including package names, sources, and whether root is required).
- Treat any guidance that installs system packages or touches /etc/systemd as high-risk: run in a sandbox or isolated VM, or review and run those install steps manually yourself.
- Inspect the repository and systemd unit referenced (/root/projects/convertagent and /etc/systemd/system/convertagent.service) before letting the agent execute anything there.
- Prefer a skill that declares required binaries (e.g., node, convertagent), provides official download/release URLs, or includes an install spec rather than implicit install instructions.
If the author provides a clear install spec (trusted release URLs, required binaries listed) and removes instructions to modify system units or to auto-install packages, the assessment could be re-evaluated as less risky.
Capability Analysis
Type: OpenClaw Skill
Name: convertagent
Version: 0.1.0
The skill provides a wrapper for a local file conversion utility (convertagent) and includes instructions in SKILL.md for the agent to automatically install missing system dependencies if a task fails. This instruction grants the agent broad, high-privilege execution authority over the host system, which is a risky capability. While the behavior is aligned with the stated purpose of file conversion, the lack of constraints on what the agent can install makes it suspicious.
Capability Assessment
Purpose & Capability
The skill claims to use a local CLI (convertagent) and even references a Node CLI at /root/projects/convertagent/dist/cli.js and a systemd unit. However the metadata declares no required binaries, no install spec, and no config paths. A conversion skill legitimately needs a conversion binary/service and possibly Node; those should be declared. Omitting them is an incoherence.
Instruction Scope
Runtime instructions reference system paths (/root/projects/convertagent, /etc/systemd/system/convertagent.service), a localhost HTTP health endpoint, and direct shell commands. They also instruct the agent to install missing system dependencies and to verify/modify files. This expands scope beyond simple file conversion (it touches system config and performs installs) and is not limited or documented in the metadata.
Install Mechanism
There is no install spec, yet the SKILL.md tells the agent to install missing system dependencies and points to a local Node CLI path. No sources, package names, or trusted release hosts are provided. That creates risk: the agent may be instructed to run package-manager or arbitrary install commands without guidance or provenance.
Credentials
The skill requests no environment variables or credentials, which is appropriate for a local conversion tool. However it implicitly expects access to system paths (root-owned repo path, systemd unit) that grant elevated privileges; those accesses are not declared and may be disproportionate.
Persistence & Privilege
The instructions imply modifying system state (installing dependencies, interacting with a systemd unit) which is a privileged action. While the skill isn't marked always:true, its guidance to install system dependencies and reference /etc/systemd may cause permanent or privileged system changes if the agent follows it.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install convertagent - After installation, invoke the skill by name or use
/convertagent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release: use ConvertAgent CLI for deterministic file conversions
Metadata
Frequently Asked Questions
What is ConvertAgent?
Use ConvertAgent for file format conversions through the local CLI. Trigger for any request to convert files (documents, images, audio, video, spreadsheets,... It is an AI Agent Skill for Claude Code / OpenClaw, with 365 downloads so far.
How do I install ConvertAgent?
Run "/install convertagent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ConvertAgent free?
Yes, ConvertAgent is completely free (open-source). You can download, install and use it at no cost.
Which platforms does ConvertAgent support?
ConvertAgent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ConvertAgent?
It is built and maintained by Senthil (@enigami12); the current version is v0.1.0.
More Skills