image-convert
Converts an image to a different format (PNG, JPG, WebP). Use when you need to change image formats, optimize for web, or prepare images for specific applications.
SKILL.md
Full skill instructions
Image Convert
Converts an image to a different format (PNG, JPG, or WebP).
Command
agent-media image convert --in <path> --format <format> [options]
Inputs
| Option | Required | Description |
|---|---|---|
--in | Yes | Input file path or URL |
--format | Yes | Output format: png, jpg, webp |
--quality | No | Quality for lossy formats (1-100, default: 80) |
--out | No | Output path, filename or directory (default: ./) |
--provider | No | Provider to use (default: auto-detect) |
Output
Returns a JSON object with the converted image path:
{
"ok": true,
"media_type": "image",
"action": "convert",
"provider": "local",
"output_path": "converted_123_abc.webp",
"mime": "image/webp",
"bytes": 23456
}
Examples
Convert PNG to WebP:
agent-media image convert --in photo.png --format webp
Convert to high-quality JPEG:
agent-media image convert --in photo.png --format jpg --quality 95
Convert with custom output directory:
agent-media image convert --in image.png --format webp --out ./converted
Providers
- local (default) - Uses sharp library, no API key required