Skip to content
screenshot-compression logo

Skill: Screenshot Compression

screenshot-compression

Compress PNG and JPEG screenshots in place using pngquant and jpegoptim, keeping the original format for maximum compatibility.

SKILL.md

Full skill instructions

Skill: Screenshot Compression

Compress screenshot images (PNG/​JPEG) in place while keeping the original format. Uses pngquant for PNG and jpegoptim for JPEG — both are highly effective for screenshot content (UI elements, text, flat colors).

Prerequisites: pngquant and jpegoptim must be installed on the system. The script will not install them automatically — it checks for their presence and prints install instructions if missing.


When to Use

The user has screenshot files that are too large and wants to reduce file size without changing format. Common scenarios:

  • Preparing images for GitHub READMEs, blog posts, or documentation
  • Reducing image sizes before committing to a repository
  • Batch compressing a directory of screenshots

Why Keep Original Format (Not WebP)

WebP has better compression, but poor compatibility in some contexts:

ContextWebP Support
Browsers (Chrome/​Firefox/​Safari/​Edge)Yes
GitHub Issues/​PRsYes
WeChat editorNo
Word / PowerPointNo
Some forums/​blog backendsVaries

Keeping PNG/​JPEG ensures the compressed images work everywhere.


Default Workflow

python /​path/​to/​skills/​screenshot-compression/​scripts/​compress_screenshots.py <files-or-directories>

The script will:

  1. Check that pngquant and jpegoptim are installed — if not, print install instructions and exit
  2. Auto-detect file format by extension
  3. Compress each file in place (overwrites the original)
  4. Print per-file and total compression summary

Dependency Check

The script requires two system tools. If either is missing, it exits with install instructions instead of proceeding. Do not install them on behalf of the user — just relay the error message so the user can install them.

Install commands:

# macOS
brew install pngquant jpegoptim

# Ubuntu / Debian
sudo apt install pngquant jpegoptim

# CentOS / RHEL
sudo yum install pngquant jpegoptim

Script Options

FlagDefaultDescription
paths (positional)requiredImage files or directories to compress
-r, --recursiveoffRecursively process directories
--png-quality80-95pngquant quality range (min-max, 0-100)
--jpeg-quality85jpegoptim max quality (0-100)

Examples

# Compress a single file
python .../​compress_screenshots.py screenshot.png

# Compress all images in a directory
python .../​compress_screenshots.py ./​images/

# Recursive directory scan
python .../​compress_screenshots.py ./​docs/ --recursive

# High quality for code screenshots
python .../​compress_screenshots.py *.png --png-quality 90-100

# Aggressive compression for thumbnails
python .../​compress_screenshots.py *.jpg --jpeg-quality 70

Quality Tuning Guide

Scenario--png-quality--jpeg-quality
General screenshots (docs, web pages)80-9585
Code screenshots (need sharp text)90-10090
Thumbnails / previews (size priority)60-8070

How It Works

PNG (pngquant)

  • Quantizes 24-bit true color (16M colors) down to an 8-bit palette (256 colors)
  • Uses Floyd-Steinberg dithering for smooth gradients
  • Screenshots are ideal candidates — UI colors are typically well under 256 unique values
  • Typical reduction: 60-80%

JPEG (jpegoptim)

  • Re-encodes at the specified quality level
  • Strips metadata (EXIF, ICC profiles, thumbnails) via --strip-all
  • Optimizes Huffman tables
  • Typical reduction: 20-50%

Important Notes

  • Files are compressed in place — the original is overwritten. Back up files first if needed.
  • Only .png, .jpg, and .jpeg files are processed. Other formats are silently skipped.
  • The script never installs dependencies. If tools are missing, it prints install instructions and exits.

More Marketing & SEO skills

copywriting logo
Marketing & SEO

copywriting

Marketing copy for homepages, landing pages, pricing pages, and other conversion-focused web pages.

53.3K 216.1K
View
flux-2-klein logo
Marketing & SEO

flux-2-klein

Fast image generation with Flux 2 Klein, optimized for sub-second iteration and multi-reference brand styling.

52 176.2K
View
marketing-psychology logo
Marketing & SEO

marketing-psychology

Psychological principles and mental models for understanding customer behavior and influencing marketing decisions.

53.3K 153K
View
content-strategy logo
Marketing & SEO

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
programmatic-seo logo
Marketing & SEO

programmatic-seo

Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.

53.3K 140.1K
View
marketing-ideas logo
Marketing & SEO

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
ai-seo logo
Marketing & SEO

ai-seo

Optimize content for discovery, citation, and visibility across AI search platforms and LLM assistants.

53.3K 136.7K
View
copy-editing logo
Marketing & SEO

copy-editing

Systematic improvement of existing marketing copy through seven focused editing passes.

53.3K 136.4K
View
site-architecture logo
Marketing & SEO

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View
revops logo
Marketing & SEO

revops

Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.

53.3K 104.9K
View
brand-guidelines logo
Marketing & SEO

brand-guidelines

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

179.7K 100.1K
View
website-to-hyperframes logo
Marketing & SEO

website-to-hyperframes

Convert websites into professional HyperFrames videos with guided storyboarding and brand-aligned composition.

57K 93.5K
View

Sales & marketing AI tools

KreadoAI logo
Sales & marketing

KreadoAI

Revolutionize Video Creation with AI-Generated Avatars and Voices

Paid
View
Followr logo
Sales & marketing

Followr

Social media on autopilot

Paid
View
Logodiffusion logo
Sales & marketing

Logodiffusion

Design custom logos instantly with AI.

Paid
View
I
Sales & marketing

Ideogram

Text-heavy marketing and design images

Freemium
View
Prompt Silo logo
Sales & marketing

Prompt Silo

Boost Your SEO with Content and SEO Silos

Free
View
Marketing Blocks logo
Sales & marketing

Marketing Blocks

Revolutionize Your Marketing with AI-Powered MarketingBlocks!

Paid
View
Scrip AI logo
Sales & marketing

Scrip AI

10X faster & free AI content creation for 100+ use cases

Free
View
Tribescaler logo
Sales & marketing

Tribescaler

Tribescaler | Make Your Tweets Go Viral

Paid
View