fast-thumbnail

Fast Thumbnail (vipsthumbnail)

Generate thumbnails at high throughput using vipsthumbnail. Distinct from fast-resize: this is purpose-built for "make small previews of every image in this folder" workflows where output is always a downscale and quality is "good enough for a thumbnail".

When to use

• Building a contact-sheet / web-gallery / index of an image library.
• Pre-rendering thumbnails for a UI / filesystem browser.
• Bulk-shrinking large originals to share / archive.

Do not use this skill when:

• The user wants the same size as the originals — that's a no-op.
• The user is upscaling — use fast-resize (or upscale-image for AI upscale).
• The user wants to keep original quality — this skill assumes lossy thumbnail-grade output.

Inputs

1. Input directory — required.
2. Size — pixel size. Single number is shorthand for NxN (fit within square). Default: 512.
3. Output dir — default: <input>/thumbnails/. The skill never overwrites originals.
4. Format — output format. Default: jpg (best size/quality balance for thumbs). Options: jpg, png, webp, avif.
5. Quality — JPEG/WebP/AVIF quality. Default: 80.
6. Recursive — --recursive to descend. Mirrors subdirectory structure under the output dir.
7. Naming — default: same base name. --prefix <s> or --suffix <s> if collision is a risk.

Procedure

1. Verify vipsthumbnail is on PATH. If missing, point at install-deps. No graceful fallback — if vips isn't installed, the skill's whole reason to exist is gone; tell the user to install or use batch-resize.

2. Enumerate input files (image extensions only).

3. For each file:

   vipsthumbnail "<input>" \
     --size "<size>" \
     --output "<output-dir>/<basename>.<ext>[Q=<quality>]"
   

   For non-JPEG outputs, the [Q=N] syntax still works for WebP/AVIF.

4. For very large batches, parallelise with find ... | xargs -P <ncpu> -I{} vipsthumbnail .... vips is internally threaded but per-image work is small enough that process-level parallelism wins on >5k batches.