SkillsAdd

okooo5km/skills4u

zipic

macOS image compression and Zipic-app expert. Drives the local Zipic.app via its `zipic` CLI (Zipic >= 1.9.5) — structured JSON results, per-file `saved_pct`, exit codes. Falls back to the URL Scheme on older builds. Supports JPEG, PNG, WebP, HEIC, AVIF, TIFF, ICNS, PDF, GIF, JPEG-XL, SVG. Batch, format conversion, resize, presets, compression history. MUST use this skill when the user mentions: compress / optimize / shrink image, image too large, batch compress, convert to WebP/AVIF/HEIC/JXL, …

First seen Mar 10, 2026

Installation

$ npx skills add okooo5km/skills4u --skill zipic
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from okooo5km/skills4u.

npx skills add okooo5km/skills4u
chinese-copyright-application 151 video-storyboard-designer 52 sketch-image-prompt 45 post-optimizer 36 xiaohongshu-expert 18 orchard 16 grid25 6 chatwoot 4

Browse all from okooo5km/skills4u

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 153
License LICENSE
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version2.1.0
LicenseMIT
CompatibilitymacOS only. Requires Zipic.app >= 1.9.5 for CLI; >= 1.9.0 for SVG via URL Scheme.
More metadata
version
2.1.0
author
十里 & FRIDAY
homepage
https://zipic.app
changelog
./CHANGELOG.md

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,705 B
  • docs SUMMARY.md 901 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 27 installs

SKILL.md

Zipic

Native macOS image compression, 100% local. Drive it via the zipic CLI; URL Scheme is a fallback only when the CLI binary isn't installed.

Compress

zipic compress --json [flags] <files-or-dirs>...

--json is required — it surfaces per-file outputbytes / savedpct and lets you map exit code to the failure mode. Pass directories directly; Zipic walks them recursively.

Need Flag
Compression level (1–6) --level 3 (1 = best quality, 6 = smallest)
Convert format --format webp (also `jpeg\ png\ avif\ heic\ jxl`)
Cap width --width 1920 (aspect kept by default)
Custom output directory --output /tmp/out/ (auto-sets --location custom)
Mirror source tree --keep-hierarchy
Use a saved preset --preset "Web 1x" (explicit flags override)
Keep sources on conversion --no-overwrite (CLI ≥ 0.2.0) or --output <dir> (any version)
Preview without running --dry-run

Source-deletion warning: flags you don't pass inherit from the user's active preset, and overwrite (GUI default ON) means a format conversion landing next to the source with the same base name deletes the source file. When the user didn't ask to replace sources: pass --no-overwrite (CLI ≥ 0.2.0, check zipic --version), or write to a separate --output dir — safe on every version. --dry-run --json echoes the effective value at data.plan.option.overwrite. On CLI 0.1.0 there is no reliable off switch (--no-overwrite is unknown and swallows the next argument) — use the --output route. Full contract: reference/cli.md.

# Convert + resize + custom output
zipic compress --json --level 3 --format webp --width 1920 --output /tmp/out/ /path/photo.png

# Batch a folder
zipic compress --json --format webp --output /tmp/out/ /path/folder

Exit codes: 0 ok / 1 runtime — read error.code from JSON / 64 bad args / 65 Zipic.app not running. prorequired (free tier hits AVIF/JXL output, SVG/APNG/AVIF/TIFF/ICNS/JXL input, daily quota, or >1 preset) returns a structured error with data.purchaseurl and data.trial_available — surface those, don't bypass.

For preset / history / dry-run / pro_required schema: reference/cli.md.

When the CLI fails

If zipic isn't on $PATH, or exit 65 persists after one retry:

bash scripts/detect.sh

Read the route field:

route Action
cli Re-run the CLI; it auto-launches Zipic and waits ~8 s for the socket.
install_cli CLI binary missing — tell user: Zipic menu bar → "Install zipic CLI". Use Fallback below for now.
url_scheme Zipic < 1.9.5, no CLI exists — tell user to upgrade. Use Fallback below.
haltnoapp Zipic not installed — suggest brew install --cask zipic or https://zipic.app.
haltnotmacos macOS only — suggest ImageMagick / cwebp.

Fallback: URL Scheme

Only when route is installcli or urlscheme. URL Scheme is fire-and-forget — no JSON, no exit code. Parameter names differ from the CLI (e.g. --output → directory=, --keep-aspect → ratio=). Load reference/url-scheme.md before constructing the URL — don't translate flags from memory; saveLocation= is a common invented param that doesn't exist (it's directory=). Verify outputs with ls -lh after open.

SVG and presets quick notes

  • SVG optimization (Pro, Zipic ≥ 1.9.0): pass .svg files like any other input. Output stays SVG — never set --format on SVG. Level 1–2 conservative, 3–4 balanced, 5–6 may simplify paths visibly.
  • Presets (CLI only): zipic preset list --json, zipic preset show "<name>" --json, zipic preset create --name "Web 2x" --level 3 --format webp --width 2400. zipic preset set-default "<name>" (CLI ≥ 0.2.0) selects the active preset — the baseline a flag-less compress inherits. Free users may keep at most 1 custom preset.
  • History (CLI only): zipic list --json --limit 20 / zipic list clear.

Zipic-usage questions

For pricing, Pro features, troubleshooting, activation, comparisons, etc. — load reference/resources.md. It indexes https://zipic.app, https://docs.zipic.app, the AI-friendly index at https://zipic.app/llms.txt, and per-topic deep links (incl. Chinese mirrors). Fetch the canonical page; don't guess.