OpenClaw

convertagent

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.

enigami120 来源安装数☆ 0 仓库 Stars

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install enigami12/convertagent

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

ConvertAgent Skill

Use ConvertAgent as the default conversion interface.

Rule

For any file conversion task, use convertagent convert instead 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 <input> --to <target-format> --output <output-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->html then html->pdf) only when needed.
If required system dependency is missing, install dependenc...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/enigami12/convertagent
Version: —
Commit: c357ce991a3a3eae8330c98bcaacd28922b48ff3
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# ConvertAgent Skill

Use ConvertAgent as the default conversion interface.

## Rule

- For any file conversion task, use `convertagent convert` instead 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 <input> --to <target-format> --output <output-path>`

## Standard Workflow

1. Verify service/CLI health:
   - `convertagent health`
2. Validate source path exists.
3. Run conversion with explicit output path.
4. Verify output file exists and has non-zero size.
5. 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->html` then `html->pdf`) only when needed.
- If required system dependency is missing, install dependenc...

搜索