{"skill":{"slug":"convertagent","displayName":"ConvertAgent","summary":"Use ConvertAgent for file format conversions through the local CLI. Trigger for any request to convert files (documents, images, audio, video, spreadsheets,...","description":"---\nname: convertagent\ndescription: Use ConvertAgent for file format conversions through the local CLI. Trigger for any request to convert files (documents, images, audio, video, spreadsheets, presentations) or when a workflow needs deterministic file conversion output.\n---\n\n# ConvertAgent Skill\n\nUse ConvertAgent as the default conversion interface.\n\n## Rule\n\n- For any file conversion task, use `convertagent convert` instead of calling engines (`pandoc`, `ffmpeg`, `imagemagick`, `libreoffice`) directly.\n- Only call engines directly if ConvertAgent cannot support the action and fallback is explicitly approved.\n\n## Quick Commands\n\n- Health check:\n  - `convertagent health`\n- List supported actions:\n  - `node /root/projects/convertagent/dist/cli.js formats`\n- Convert file:\n  - `convertagent convert <input> --to <target-format> --output <output-path>`\n\n## Standard Workflow\n\n1. Verify service/CLI health:\n   - `convertagent health`\n2. Validate source path exists.\n3. Run conversion with explicit output path.\n4. Verify output file exists and has non-zero size.\n5. Return/attach converted artifact.\n\n## Examples\n\n- Markdown to PDF:\n  - `convertagent convert /path/file.md --to pdf --output /tmp/file.pdf`\n- PNG to WEBP:\n  - `convertagent convert /path/image.png --to webp --output /tmp/image.webp`\n- XLSX to CSV:\n  - `convertagent convert /path/sheet.xlsx --to csv --output /tmp/sheet.csv`\n- MP4 to MP3:\n  - `convertagent convert /path/video.mp4 --to mp3 --output /tmp/audio.mp3`\n\n## Supported Action Map (Current)\n\n- Documents: `pdf->docx`, `docx->pdf`, `html->pdf`, `md->pdf`, `md->html`, `md->docx`\n- Sheets/Slides: `xlsx->csv`, `csv->xlsx`, `pptx->pdf`\n- Images: `jpg->png`, `png->jpg`, `png->webp`, `webp->png`, `svg->png`, `image-resize`, `image-compress`\n- Media: `mp4->mp3`, `wav->mp3`, `mp4->gif`, `any-video->mp4`\n\n## Paths\n\n- Repo: `/root/projects/convertagent`\n- Service unit: `/etc/systemd/system/convertagent.service`\n- Runtime API health: `http://localhost:3001/health`\n\n## Failure Handling\n\n- If conversion fails, capture stderr and report exact failing action.\n- If unsupported mapping is requested, choose a supported intermediate chain (e.g., `md->html` then `html->pdf`) only when needed.\n- If required system dependency is missing, install dependency and retry once.\n","tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":774,"installsAllTime":29,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1772881729824,"updatedAt":1778996305907},"latestVersion":{"version":"0.1.0","createdAt":1772881729824,"changelog":"Initial release: use ConvertAgent CLI for deterministic file conversions","license":null},"metadata":null,"owner":{"handle":"enigami12","userId":"s17c3dvapqtm355e56wvxmy77n884vgg","displayName":"Senthil","image":"https://avatars.githubusercontent.com/u/224040528?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089792203}}