← Back to Skills Marketplace
tiantian-pago

Local File Converter

by tiantian-pago · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ✓ Security Clean
308
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install local-file-converter
Description
本地文件转换技能,使用命令行工具实现 1000+ 格式互转。
README (SKILL.md)

Local File Converter

本地文件转换技能,使用命令行工具实现 1000+ 格式互转。

能力

  • 图片: JPG, PNG, WebP, HEIC, GIF, BMP, TIFF, SVG 等
  • 视频: MP4, AVI, MKV, MOV, WebM, GIF 等
  • 音频: MP3, FLAC, WAV, AAC, OGG, M4A 等
  • 文档: PDF, DOCX, DOC, EPUB, MOBI, TXT, Markdown 等
  • 数据: JSON, YAML, XML, CSV 等

底层工具

工具 用途
ffmpeg 音视频转换
imagemagick 图片转换
libreoffice 文档转换
pandoc 文档/标记转换
calibre 电子书转换(按需安装)

安装命令

# Debian/Ubuntu
sudo apt install ffmpeg imagemagick libreoffice pandoc calibre

# macOS
brew install ffmpeg imagemagick libreoffice pandoc
brew install --cask calibre

使用方式

用户说类似:

  • "把这个图片转成 WebP"
  • "将 video.mp4 转换成 GIF"
  • "把 document.docx 转为 PDF"
  • "转换这本书为 EPUB 格式"

技能自动:

  1. 识别源文件和目标格式
  2. 选择合适的转换工具
  3. 执行转换命令
  4. 返回结果文件路径

命令参考

图片转换 (ImageMagick)

convert input.png output.webp
convert image.jpg image.png
mogrify -format webp *.png
convert input.jpg -resize 1920x1080 output.jpg

视频/音频转换 (FFmpeg)

ffmpeg -i input.mp4 -vf "fps=10,scale=640:-1" output.gif
ffmpeg -i input.mp4 -c:v libx265 output.mkv
ffmpeg -i video.mp4 -q:a 0 -map a output.mp3
ffmpeg -i input.wav -b:a 320k output.mp3

文档转换 (LibreOffice)

libreoffice --headless --convert-to pdf document.docx
libreoffice --headless --convert-to docx document.pdf

文档/标记转换 (Pandoc)

pandoc input.md -o output.pdf
pandoc input.md -o output.docx
pandoc input.html -t markdown -o output.md

电子书转换 (Calibre)

ebook-convert input.epub output.mobi
ebook-convert input.epub output.pdf

注意事项

  • ⚠️ 大文件转换可能需要较长时间
  • ⚠️ 视频转换消耗 CPU,建议在空闲时进行
  • ⚠️ 有损转换可能降低质量
  • ⚠️ HEIC 格式需要 libheif 支持

状态检查

ffmpeg -version | head -1
convert --version | head -1
libreoffice --version | head -1
pandoc --version | head -1
Usage Guidance
This skill appears to do what it says: run local conversion commands using standard tools. Before installing/using it: (1) verify the author/source (registry metadata and _meta.json owner/version mismatch noted), (2) inspect convert.sh (it invokes binaries on your machine and will create/move files), (3) install conversion tools from official package managers, and (4) avoid converting untrusted files with ImageMagick, LibreOffice, Pandoc or similar tools (these have historically been attack vectors for malicious input). If you need stronger isolation, run conversions inside a sandbox/container or VM and do not grant elevated privileges.
Capability Analysis
Type: OpenClaw Skill Name: local-file-converter Version: 1.0.3 The skill is a legitimate file conversion utility that wraps standard command-line tools such as FFmpeg, ImageMagick, LibreOffice, and Pandoc. The `convert.sh` script is well-implemented, utilizing shell case statements to validate output formats and employing proper variable quoting to prevent common shell injection vulnerabilities. No evidence of data exfiltration, persistence mechanisms, or malicious prompt injection was found in the code or documentation.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md and convert.sh consistently implement a local file-conversion capability using ffmpeg, ImageMagick, libreoffice, pandoc and calibre. However, the package source is unknown and _meta.json ownerId/version differ from the registry metadata (minor metadata inconsistency), which is a trust signal to verify the origin.
Instruction Scope
SKILL.md instructs only local conversion actions (detect formats, pick tool, run conversion, return output path). convert.sh only reads the given input file, creates an output directory (or uses OUTPUT_DIR env var), invokes local conversion binaries and reports the result—no attempts to read unrelated files or transmit data externally.
Install Mechanism
This is instruction-only (no install spec). SKILL.md suggests installing common packages via apt or brew (official package managers). No remote downloads or archive extraction are present in the bundle.
Credentials
The skill requires no credentials or special environment variables; convert.sh accepts an optional OUTPUT_DIR environment variable which is reasonable and transparent.
Persistence & Privilege
The skill does not request persistent or elevated privileges (always: false). It does not attempt to modify other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install local-file-converter
  3. After installation, invoke the skill by name or use /local-file-converter
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Initial clean release - no private info
v1.0.2
Remove hardcoded paths, use OUTPUT_DIR env var
v1.0.1
Remove private info, simplify SKILL.md
v1.0.0
Initial release - 1000+ format file conversion using ffmpeg, imagemagick, libreoffice, pandoc
Metadata
Slug local-file-converter
Version 1.0.3
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is Local File Converter?

本地文件转换技能,使用命令行工具实现 1000+ 格式互转。 It is an AI Agent Skill for Claude Code / OpenClaw, with 308 downloads so far.

How do I install Local File Converter?

Run "/install local-file-converter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Local File Converter free?

Yes, Local File Converter is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Local File Converter support?

Local File Converter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Local File Converter?

It is built and maintained by tiantian-pago (@tiantian-pago); the current version is v1.0.3.

💬 Comments