convertagent

What This Skill Does

The ConvertAgent skill serves as the unified, centralized interface for all file transformation tasks within the OpenClaw environment. By abstracting away the complexities of low-level tools like Pandoc, FFmpeg, ImageMagick, and LibreOffice, ConvertAgent provides a deterministic, reliable CLI wrapper. It ensures that file conversions—whether they involve documents, high-fidelity images, audio, or video—follow a standardized workflow. By requiring the use of convertagent convert rather than raw system calls, it adds a layer of safety, observability, and error handling that is crucial for robust automation workflows.

Installation

To integrate this skill into your environment, use the OpenClaw skill hub. Run the following command in your terminal: clawhub install openclaw/skills/skills/enigami12/convertagent Ensure that your environment has the necessary system dependencies installed, as ConvertAgent acts as an orchestration layer for underlying media and document processing libraries. You can verify the installation and operational status at any time by running convertagent health.

Use Cases

ConvertAgent is ideal for high-volume, automated file processing. Common use cases include:

• Transforming documentation: Converting markdown-based technical documentation into polished PDFs or DOCX files for stakeholders.
• Media transcoding: Extracting audio tracks from video files (e.g., MP4 to MP3) for transcription services or converting high-resolution images to optimized web formats like WEBP.
• Data interchange: Seamlessly shifting between spreadsheet formats, such as converting legacy XLSX files to CSV for ingestion into databases or data analysis tools.
• Workflow automation: Acting as an intermediate step in complex CI/CD or content pipeline automation where format consistency is required.

Example Prompts

1. "Convert the technical specifications document in my project folder from Markdown to PDF and save it to the builds directory."
2. "I have a large PNG screenshot, can you convert it to WEBP format to optimize the file size?"
3. "Please take the interview recording file and extract the audio into an MP3 format so I can upload it to the whisper engine."

Tips & Limitations

To maximize the reliability of your workflows, always verify that the source path exists before triggering a conversion. If you encounter an error, check the stderr output; ConvertAgent will provide specific feedback if the conversion mapping is unsupported. If you face a complex requirement not listed in the supported action map, consider chaining conversions (e.g., Markdown -> HTML -> PDF). Note that ConvertAgent is designed to be the primary interface; only bypass this and call engines directly (like FFmpeg) if absolutely necessary and when explicitly approved, as this may break the internal state tracking of the OpenClaw agent.