pixmind-image-compress

Pixmind Image Compress

Cloud-powered image compression and resize. Compress JPG, PNG, WebP, HEIC photos to WebP, AVIF or smaller JPG — save 60-90% file size with zero local dependencies.

Powered by Pixmind + Tencent Cloud COS imageMogr2.

Why this skill?

• Zero install — No sharp, ImageMagick, or native modules. Runs on any platform with just an API key.
• Cloud-processed — Handles HEIC, AVIF, TPG formats that local tools struggle with.
• Scene presets — One command for web, WeChat, email, or archival use.
• Batch ready — Compress entire folders recursively.
• Safe by default — Never overwrites originals, auto-numbered output.

When to use

Use this skill when the user mentions:

1. Compress — "图片太大"、"压缩一下"、"缩小文件"、"reduce image size"、"compress photo"、"file too large"
2. Format conversion — "转成 JPG"、"PNG 转 WebP"、"HEIC 转 JPG"、"convert to webp"、"change format"
3. Resize — "缩小到 1920px"、"调整尺寸"、"resize image"、"reduce dimensions"、"scale down"
4. Batch — "批量压缩"、"处理这个文件夹"、"compress all images"、"batch resize"
5. Scene optimization — "用于邮件附件"、"上传网站"、"微信发送"、"optimize for web"、"shrink for email"
6. Typical triggers:
   • "帮我压缩这张图片，文件太大了发不了微信"
   • "Screenshot.png is 10MB, make it smaller"
   • "Convert all PNGs in this folder to WebP"
   • "Resize these photos to max 1920px width"

Do NOT trigger for:

• Image generation (use pixmind-image skill)
• Image editing (crop, rotate, watermark, filters)
• Image analysis (OCR, content recognition, EXIF reading)

Prerequisites

1. Register at pixmind.io — 200 bonus points on signup (free trial)
2. Create an API key in the API Platform dashboard
3. Set env PIXMIND_API_KEY with your key

Quick Start

# Compress a single image (local file)
node {baseDir}/compress.js --file ~/Desktop/photo.png --preset web

# Compress from URL
node {baseDir}/compress.js --url https://example.com/image.jpg --quality 80 --format webp

# Resize to max 1920px width
node {baseDir}/compress.js --file photo.jpg --width 1920

# Batch compress a folder
node {baseDir}/compress.js --dir ~/Pictures/ --preset web --recursive

Presets

Quick scene-based compression — no need to remember quality numbers:

API Details

Endpoint: POST https://aihub-admin.aimix.pro/api-platform/v1/image/compress Auth: Header Authorization: Bearer {API_KEY}

Request Body (JSON)

Response Format

{
  "code": 1000,
  "message": "success",
  "data": {
    "originalUrl": "https://bucket.cos.region.myqcloud.com/image.jpg",
    "compressedUrl": "https://bucket.cos.region.myqcloud.com/image.jpg?imageMogr2/format/webp/quality/75",
    "originalSize": 1024000,
    "compressedSize": 256000,
    "format": "webp",
    "quality": 75,
    "width": 800,
    "height": 600
  }
}

Supported Formats

Input: JPG, JPEG, PNG, WebP, GIF, BMP, HEIC, HEIF Output: webp, jpg, png, avif, heif, tpg

CLI Options

Output Rules

• Compressed files saved to ~/Downloads/compressed-images/{date}/ by default
• Original files are never modified or overwritten
• Duplicate filenames auto-numbered: photo_001.jpg, photo_002.jpg
• Batch mode preserves original directory structure

Guidelines

1. For local files, the script auto-reads and converts to Base64 for upload
2. Default to quality 75 — good balance of quality and size
3. Match presets to use cases: web for sites, wechat for sharing, email for attachments
4. When resizing, specify only one dimension to maintain aspect ratio
5. For batch processing, show progress and total savings summary
6. After compression, always show before/after size and savings percentage
7. Prefer webp for web — best compression with good quality
8. For photos: recommend jpg or webp; for screenshots/diagrams: png or webp
9. HEIC (iPhone) photos are natively supported — no extra dependencies needed