Skill guide

Image format conversion

Convert static images among JPEG, PNG, WebP, and base64 with real, verified output files.

Use the bundled converter to decode the input, apply the output format's encoding rules, and write the requested destination. This preserves the distinction between changing a file's representation and editing its visual content.

Package version 0.1.0-beta.6

Included with Faye Image Utility

When to use

Use this when you need a supported static image in another container, or need to encode or decode base64.

What to provide

  • An accessible input file, raw base64, or a data URL.
  • The target format, an explicit output path when location matters, and a background color for transparent input going to JPEG if white is unsuitable.

Expected results

  • A verified JPEG, PNG, WebP, or base64 text output.
  • The actual destination and any material conversion limits or encoding decisions.

Example requests

Try this request

Codex
Codex request
$faye-image-format-converter Convert assets/banner.png to assets/banner.webp. Preserve transparency and report the written file; do not overwrite an existing destination.
Grok
Grok request
/faye-image-format-converter Convert assets/banner.png to assets/banner.webp. Preserve transparency and report the written file; do not overwrite an existing destination.
Antigravity
Antigravity request
/faye-image-format-converter Convert assets/banner.png to assets/banner.webp. Preserve transparency and report the written file; do not overwrite an existing destination.

Requirements and limits

Before you start

  • The bundled image_processor agent executes and verifies each conversion.
  • Python 3.10 or newer with venv/ensurepip.
  • Pillow 12.3.0 or newer with LittleCMS2, accessed through the plugin’s Python launcher. Locked wheels are installed in the project-local environment.
  • FAYE_WORKSPACE_ROOT must identify the active project. The first environment setup needs access to the locked dependency wheels.

Scope and limitations

  • Animated inputs and unsupported formats are rejected; this skill does not resize, crop, annotate, or generate images.
  • JPEG flattens transparency to white unless another background is specified. Source metadata is sanitized and working pixels use sRGB.
  • Inputs are limited to 256 MiB, 128 million decoded pixels, and 32,768 pixels per edge. Replacing an existing output requires explicit authorization.
Technical source

The hosted file belongs to the package version shown on this page.

plugins/faye-image-utility/skills/faye-image-format-converter

Open source file