File Ops

File Ops

Workflow

1. Run health check to discover available operations and missing dependencies:

`` .venv/bin/python /scripts/file_ops.py health ``

1. Run the appropriate command with explicit paths:

`` .venv/bin/python /scripts/file_ops.py --input /path/to/file [options] ``

1. Read the JSON result and report the output path, metadata, or extracted text to the user.
2. If a dependency is missing, surface the exact gap from the health report or error message.

Replace ` with the absolute path to this skill directory. The script must be invoked with the Python interpreter from the skill's own .venv (located at /.venv). Run /scripts/setup.sh if the .venv` does not exist.

Commands

| Command | Purpose | Key flags | |---------|---------|-----------| | health | Report runtime capabilities | (none) | | convert | Convert file format | --input, --to, --output, --sheet, --overwrite | | inspect | Return file metadata as JSON | --input | | archive | Create or extract zip | --input (multi), --output, --extract | | extract-text | Extract readable text | --input |

Supported Conversions

• Image formats: png, jpg, jpeg, webp, gif, bmp, tiff
• pdf -> docx
• xlsx -> csv
• xls -> csv (requires xlrd, not installed by default)
• docx -> pdf (requires LibreOffice)
• html/md/markdown -> pdf (requires wkhtmltopdf)

Notes

• All operations are path-based. Do not wrap file content in base64 unless the user explicitly asks.
• Run health before promising support for optional conversions or operations.
• For Excel conversion, --sheet accepts a sheet name or zero-based index.
• If a conversion or operation is unavailable, surface the exact dependency gap instead of falling back silently.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wowyuarm
• Source: wowyuarm/file-ops-skill
• License: MIT

Install and usage instructions live in the source repository linked above.