skilld
All skills
oaustegard avatar

/converting-files

@4b31e7d
by Oskar Austegardoaustegard/claude-skills150 stars
6

Convert a file from one format to another inside the container — documents, images, audio, video. Routes to the right engine (pandoc, LibreOffice, ImageMagick, ffmpeg) by format pair. Triggers on "convert X to Y", "turn this docx into a pdf", "make a gif from this mp4", "md to docx", "batch-convert these images", or any single-file or batch format change where the source and target extensions differ. NOT for editing content (use docx/pptx/xlsx/pdf skills), creating files from scratch, or reading a file you already have in context.

Ask your Agent

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/converting-files

This session only. Nothing lands on disk.

README.md

≈385 tokens on demand. Your agent reads this file only when SKILL.md points to it.

converting-files

Convert a file from one format to another inside the Claude.ai container — documents, images, audio, video — by routing to the right engine among pandoc, libreoffice (headless), ImageMagick, and ffmpeg.

The value is the routing, not the subprocess call: pandoc mangles a real .docx into PDF (LibreOffice is the tool); pandoc is better than LibreOffice from markup; mp4 → gif is an ffmpeg job, not ImageMagick. scripts/convert.py is a dispatcher that picks the engine by format pair.

# Confirm the route without running anything:
python3 scripts/convert.py --plan in.docx out.pdf

# Convert:
python3 scripts/convert.py in.docx out.pdf      # LibreOffice
python3 scripts/convert.py notes.md notes.docx  # pandoc
python3 scripts/convert.py clip.mp4 clip.gif    # ffmpeg

Full routing table, batch usage, engine-flag passthrough, and the gotchas that cost a re-run (LibreOffice naming, headless single-instance, markup→jira anchors, IM6 policy) live in SKILL.md. Version history in CHANGELOG.md.

Why not VERT (or any web converter)

VERT (vert.sh) is a Svelte/WASM browser app wrapping these same engines for a human at a tab who wants local privacy — no importable CLI or library. In the container the native binaries are already present with full filesystem access and no browser memory ceiling, so they're strictly faster and more capable for programmatic use. This skill is the in-container equivalent of what VERT does in a tab.

Source: SKILL.md on GitHub

Third-party checks

No alerts3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    This skill provides a secure utility for converting files between various formats (documents, images, audio, video) by routing requests to pre-installed system engines like pandoc, LibreOffice, ImageMagick, and ffmpeg. The implementation uses a Python dispatcher script that follows best practices for subprocess execution, mitigating command injection risks.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: LOW · No issues

Provenance

Signed by skilld at 4b31e7d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

Capability

metadata
{
  "version": "0.1.1"
}

README badge

README badge for oaustegard/claude-skills/converting-files