# Image To Webp

> Use when converting PNG/JPG images to WebP for web deployment — covers dimension limits by use-case, quality settings, batch conversion, reference updates in Astro files, and cleanup of originals.

- Skill: `casoon/image-to-webp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add casoon/image-to-webp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/casoon/image-to-webp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: casoon (https://skillmd.com/u/casoon)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/casoon/image-to-webp

---


# Image → WebP Conversion

## Dimension presets

| Use case | Max width | Notes |
|---|---|---|
| Content / beside-text | 1200px | Standard für Seiten-Bilder |
| Team / Portrait | 800px | Quadratische Darstellung, 800 reicht |
| Hero / full-bleed | 1920px | Nur wenn wirklich vollflächig |
| Wide content | 1600px | Gruppenfotos, Panoramas |

## Quality

- **85** — Standard für Fotos (gutes Verhältnis, keine sichtbaren Artefakte)
- **90** — Wenn Kunde auf Schärfe besteht
- **75** — Logos/Grafiken mit Flächen (artefakte weniger sichtbar)

## Workflow

1. Dimensionen der Quell-Bilder prüfen: `python3 -c "from PIL import Image; ..."`
2. Konvertieren mit `scripts/convert.py`
3. Referenzen in `.astro`-Dateien aktualisieren (grep → sed)
4. Original-PNGs löschen

## Gotchas

- Pillow muss installiert sein: `pip3 install Pillow` — auf macOS meist vorhanden
- `method=6` in Pillow = langsamste aber beste WebP-Kompression — vertretbar für einmalige Konvertierung
- PNG mit Transparenz (RGBA): erst in RGB konvertieren, sonst WebP-Fehler: `img.convert('RGB').save(...)`
- Nach dem Löschen der PNGs: git-tracked PNGs brauchen `git rm`, untracked einfach `rm`

## Script