Image

When to Use

Use when the main artifact is an image file or visual asset, especially when format choice, resizing, cropping, compression, metadata, transparency, color profile, responsive delivery, social specs, marketplace requirements, or print readiness matter.

If the task is destination-specific, load the matching file before deciding:

1. web.md for responsive delivery, LCP/CLS, srcset, lazy loading, SVG, and modern web formats.
2. social.md for platform dimensions, safe zones, and feed/story/banner exports.
3. ecommerce.md for marketplace product-image rules, white backgrounds, zoom, and catalog consistency.
4. photography.md for RAW, ICC profiles, print export, EXIF, and non-destructive editing.
5. branding.md for logos, icons, favicons, app icons, SVG consistency, and small-size legibility.
6. screenshots.md for UI captures, documentation images, annotations, redaction, and marketing/device frames.
7. accessibility.md for alt text, decorative vs informative images, text in images, charts, and contrast-aware image delivery.
8. commands.md when the user needs concrete ImageMagick or Pillow examples.

Keep the main workflow in this file, then pull in the specialized file for the exact delivery context instead of guessing from generic image advice.

Quick Reference

| Situation | Load | Why | |-----------|------|-----| | Web optimization, responsive images, lazy loading, SVG | web.md | Avoid CLS/LCP mistakes, oversized assets, and wrong web formats | | Color profiles, metadata, RAW, print, non-destructive workflows | photography.md | Protect color intent, print readiness, and master-file quality | | Social platform dimensions, safe zones, banners, previews | social.md | Prevent unsafe crops, unreadable text, and uploader recompression surprises | | Product photos, marketplace standards, catalog consistency | ecommerce.md | Preserve zoom detail, white-background compliance, and catalog consistency | | Logos, favicons, SVGs, app icons, icon sets | branding.md | Protect small-size legibility, SVG consistency, and multi-format icon delivery | | UI screenshots, docs captures, redaction, annotations | screenshots.md | Avoid blurry captures, privacy leaks, and misleading before/after comparisons | | Alt text, text-in-image risk, charts, decorative vs informative images | accessibility.md | Keep image work usable and compliant, not only visually correct | | ImageMagick and Pillow commands | commands.md | Use concrete commands once the export decision is already clear |

Fast Workflow

1. Identify the asset type: photo, screenshot, UI capture, logo, diagram, social card, product image, or print source.
2. Identify the destination: web page, social upload, marketplace gallery, print handoff, internal archive, or further editing pipeline.
3. Decide whether the source should remain vector, layered, or RAW instead of being flattened too early.
4. Inspect the file before editing: dimensions, aspect ratio, orientation, transparency, color profile, metadata, and current compression damage.
5. Load the destination-specific file if the job is web, social, ecommerce, photography/print, branding, screenshots, accessibility, or command-heavy.
6. Make the minimum safe transformation set: crop, resize, convert, compress, strip or preserve metadata, and export.
7. Validate the exported result in the destination context, not only in the editor.

Asset-Type Defaults

| Asset type | Usually best starting point | Watch out for | |-----------|-----------------------------|---------------| | Photo | WebP or AVIF for web, JPEG fallback, layered/RAW master for editing | Color profile shifts, overcompression, platform recompression | | Product photo | JPEG or WebP for delivery, high-res clean master | White background, edge cleanup, zoom detail, consistency | | Screenshot or UI capture | PNG or lossless WebP | JPEG blur, privacy leaks, unreadable text | | Logo or simple icon | SVG master, PNG fallbacks only when needed | Tiny details, unsupported SVG pipelines, dark/light contrast | | Social/OG card | PNG or high-quality JPEG sized for preview | Unsafe crop, tiny text, double compression | | Diagram or chart | SVG when possible, PNG when fixed raster needed | Thin lines, low contrast, missing explanatory text | | Print image | TIFF or high-quality JPEG with correct profile | Wrong profile, wrong physical size, no bleed |

Core Rules

1. Choose the workflow by destination, not by habit

1. Web delivery, social export, ecommerce prep, print output, and archive preservation are different image jobs.
2. A screenshot, product photo, logo, infographic, and print asset should not default to the same format or compression strategy.
3. Image generation is a different workflow from image processing; treat generated assets as inputs that still need inspection and export discipline.
4. If the destination is specialized, read the matching file before locking format, crop, quality, or metadata decisions.
5. If the file will be edited again later, preserve a master-grade source before making lightweight delivery exports.

2. Pick formats by content, not by trend

1. Photos usually want AVIF or WebP for modern web delivery, with JPEG fallback when compatibility matters.
2. Screenshots, UI captures, diagrams, and text-heavy graphics often need PNG or lossless WebP to avoid blurry edges.
3. Logos, icons, and simple illustrations should stay vector (.svg) when the target supports it.
4. Transparency changes the decision: JPEG drops alpha, while PNG, WebP, and AVIF can preserve it.
5. Animated GIF is rarely the best output; animated WebP, MP4, or WebM are usually smaller and cleaner.
6. TIFF, PSD, layered formats, and RAW files are working formats or masters, not normal delivery outputs.
7. If a platform re-encodes uploads aggressively, optimize for how that platform recompresses rather than for ideal local viewing.
8. Screenshots, diagrams, and charts with sharp edges often benefit from lossless output even when photos do not.

3. Preserve color, transparency, and detail deliberately

1. Web assets should usually end in sRGB unless the destination explicitly needs something else.
2. Stripping or changing ICC profiles can shift colors even when the pixels themselves did not change.
3. Transparent assets need alpha-safe formats and validation against both light and dark backgrounds.
4. Repeated lossy saves compound damage, so keep a clean source and minimize recompression loops.
5. Upscaling, denoising, sharpening, and background removal should be treated as visible edits, not harmless export steps.

4. Resize, crop, and compress in the right order

1. Decide aspect ratio first, crop second, resize third, and compress last.
2. Do not upscale by default; extra pixels do not create missing detail.
3. Retina or HiDPI exports should be intentional, not automatic overkill.
4. As a starting point, 2x is the normal Retina export and 3x should be deliberate, not default.
5. Social cards, ecommerce slots, and marketplace galleries often crop aggressively, so protect the real focal area and any critical text.
6. A file that fits the pixel spec can still fail if the crop cuts off faces, products, labels, or UI affordances.
7. If text is embedded inside the image, validate at the smallest realistic preview size, not only at full resolution.

5. Treat metadata and orientation as real delivery concerns

1. EXIF orientation can make an image look upright in one viewer and rotated in another after export.
2. Public web assets usually should strip GPS and unnecessary camera metadata.
3. Copyright, author, or provenance metadata may need to be preserved for editorial, legal, or archive use.
4. Metadata decisions are part of the workflow, not an afterthought.
5. Preserve filenames and output naming conventions when downstream systems map assets by exact names or SKU patterns.
6. Do not strip metadata blindly if the workflow depends on authoring info, rights data, timestamps, or orientation.

6. Use practical budgets and delivery defaults

1. For web work, use budgets as a forcing function, not as decoration.
2. A useful default starting point is: hero image under 200 KB, content image under 100 KB, thumbnail under 30 KB, raster icon under 5 KB.
3. Reserve layout space with explicit dimensions or aspect ratio when the image ships on the web.
4. Do not lazy-load the primary hero or likely LCP image.
5. A file that "looks fine locally" is not finished if it breaks CLS, LCP, or responsive delivery in the real page.
6. A small file is not automatically good if detail, text legibility, product edges, or gradients collapse.
7. If a platform will recompress the image anyway, leave enough headroom that the second compression does not destroy the result.

7. Validate against the actual destination

1. Platform specs are not interchangeable: web hero, social preview, app store art, marketplace gallery, and print ad all have different constraints.
2. Ecommerce images may need background consistency, edge cleanliness, square-safe crops, and zoom-friendly detail.
3. Social images need safe composition because feeds crop previews differently across platforms.
4. Print assets care about physical size, bleed, and color handling in ways web exports do not.
5. If the asset ships on the web, remember the surrounding delivery too: width, height, alt text, and whether the image should carry text at all.
6. If the asset will be uploaded to a third-party platform, check the post-upload result because many pipelines resize, strip profiles, flatten metadata, or recompress again.
7. If the image carries meaning, validate its accessibility too: alt text strategy, text legibility, decorative vs informative role, and whether the meaning should have stayed in HTML or surrounding copy.

8. Batch safely and keep the original reversible

1. Work from originals or clean masters, not from already-optimized outputs.
2. Batch processing should apply consistent rules, but still spot-check representative files before touching the whole set.
3. One wrong crop preset, color conversion, or lossy export can damage an entire batch quickly.
4. Keep per-destination exports separated from masters so the next edit does not accidentally start from a degraded derivative.

Specialized Cases Worth Loading

1. Load branding.md when the asset is a logo, app icon, favicon, social avatar, badge, or reusable icon set.
2. Load screenshots.md when the asset is a UI capture, bug report image, tutorial screenshot, release-note image, or device-framed marketing visual.
3. Load accessibility.md when the image needs alt text, contains embedded text, carries chart/diagram meaning, or may be decorative instead of informative.

What Good Looks Like

1. The chosen format matches the content and the destination, not a blanket preference.
2. The exported file keeps the right focal area, text legibility, transparency, and color intent.
3. Metadata is preserved or stripped deliberately.
4. The file size is efficient without obvious visual damage.
5. The asset still works after the actual upload, embed, or platform preview step.
6. The agent has not flattened a vector, layered, or RAW source earlier than necessary.
7. The asset is still understandable in its real use context, not just visually attractive in isolation.

Common Traps

1. Saving transparent images as JPEG and silently losing the alpha channel.
2. Using JPEG for screenshots or UI captures and turning sharp text into mush.
3. Shipping a file that matches the requested dimensions but has the wrong aspect ratio or unsafe crop.
4. Recompressing the same JPEG multiple times and blaming the tool instead of the workflow.
5. Stripping metadata and accidentally breaking orientation, licensing context, or provenance needs.
6. Forgetting sRGB and wondering why colors shift between editing tools, browsers, and marketplaces.
7. Using SVG where the target platform strips it, rasterizes it badly, or blocks it entirely.
8. Assuming AVIF or WebP is safe everywhere when some platforms, email clients, or upload pipelines still normalize back to JPEG or PNG.
9. Embedding critical text into images where HTML or native UI text should have carried the meaning.
10. Hitting the file-size budget but missing visual quality because the image was resized, cropped, or sharpened badly.
11. Rasterizing a logo too early and then fighting blurry exports forever.
12. Shipping a screenshot with secrets, personal data, or unstable timestamps still visible.
13. Treating alt text, captions, or chart summaries as someone else's problem after the pixels look good.

Related Skills

Install with clawhub install <slug> if user confirms:

1. image-edit — Masking, cleanup, inpainting, and targeted visual edits.
2. image-generation — AI image generation and editing across current model providers.
3. photography — Capture, color, and print-oriented photo workflows.
4. svg — Vector graphics workflows when raster files are the wrong output.
5. ecommerce — Marketplace and product-listing requirements that often constrain image delivery.

Feedback

1. If useful: clawhub star image
2. Stay updated: clawhub sync