Agent skill

Zipic

by okooo5km in okooo5km/Skills4U

Local image compression and Zipic-app expert for macOS and native Windows.

MITAuto-check passedMedia & Creative

Install Zipic

skills CLI
$ npx skills add okooo5km/Skills4U --skill zipic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install okooo5km/Skills4U zipic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/okooo5km/Skills4U.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/zipic .claude/skills/zipic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
zipic
GitHub stars
183
Token cost
~2.2k tokens
SKILL.md length
931 words
Files
10 (incl. scripts)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Local image compression and Zipic-app expert for macOS and native Windows.

  • Shrinking images
  • SKILL.md covers Platform and shell, Compress, When the CLI fails and Fallback: URL Scheme, plus 2 more sections
  • Runs PowerShell and Shell scripts from its folder; calls bash and brew
  • Batch compression

What it does

Zipic is an agent skill from okooo5km/Skills4U. Local image compression and Zipic-app expert for macOS and native Windows. Uses the Zipic CLI with JSON results, per-file savedpct and exit codes; URL Scheme is a limited fallback. Use for compressing, optimizing or shrinking images, batch compression, conversion to WebP/AVIF/HEIC/JXL (including lossless JPEG XL), SVG optimization, resizing, presets and compression history. Also use for Zipic pricing, Pro features, activation, free-tier limits, troubleshooting, comparisons, CLI setup and workflow integration…

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts (for example `CHANGELOG.md`, `evals/evals.json` and `reference/cli.md`). Compatibility notes: macOS with Zipic.app = 1.9.5 for CLI (= 1.9.0 for SVG via URL Scheme), or Windows 10 build 19041+ / Windows 11 with packaged Zipic and its zipic.exe execution…

It sits in Media & Creative, covering Image editing. It works with macOS, PowerShell and Linux. The licence is MIT.

When your agent uses it

  • Shrinking images
  • Batch compression
  • Conversion to WebP/AVIF/HEIC/JXL (including lossless JPEG XL)
  • SVG optimization

Example prompts

  • “/zipic”

Requirements

  • A Bash shell
  • PowerShell
  • Compatibility (from SKILL.md): macOS with Zipic.app >= 1.9.5 for CLI (>= 1.9.0 for SVG via URL Scheme), or Windows 10 build 19041+ / Windows 11 with packaged Zipic and its zipic.exe execution alias. Windows examples support PowerShell 5.1 and 7. No native Linux CLI; WSL requires Windows interop and Windows-accessible paths.

What it can do on your machine

Read from SKILL.md and the folder at commit 7ffd3a4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (PowerShell and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • zipic.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    macOS with Zipic.app >= 1.9.5 for CLI (>= 1.9.0 for SVG via URL Scheme), or Windows 10 build 19041+ / Windows 11 with packaged Zipic and its zipic.exe execution alias. Windows examples support PowerShell 5.1 and 7. No native Linux CLI; WSL requires Windows interop and Windows-accessible paths.

    From compatibility in the SKILL.md frontmatter.

Context cost

Zipic loads about 2.2k tokens when it runs. Until then it costs about 180 tokens; SKILL.md has 931 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~180
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from okooo5km/Skills4U at commit 7ffd3a4, republished under its MIT licence (© okooo5km). 931 words, ~2,152 tokens.

Download SKILL.mdSave it as .claude/skills/zipic/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
zipic
description
Local image compression and Zipic-app expert for macOS and native Windows. Uses the Zipic CLI with JSON results, per-file saved_pct and exit codes; URL Scheme is a limited fallback. Use for compressing, optimizing or shrinking images, batch compression, conversion to WebP/AVIF/HEIC/JXL (including lossless JPEG XL), SVG optimization, resizing, presets and compression history. Also use for Zipic pricing, Pro features, activation, free-tier limits, troubleshooting, comparisons, CLI setup and workflow integration. Requires the installed Zipic GUI in the same execution environment. Windows uses the packaged zipic.exe alias and PowerShell; macOS uses Zipic.app. Format support and integrations differ by platform.
compatibility
macOS with Zipic.app >= 1.9.5 for CLI (>= 1.9.0 for SVG via URL Scheme), or Windows 10 build 19041+ / Windows 11 with packaged Zipic and its zipic.exe execution alias. Windows examples support PowerShell 5.1 and 7. No native Linux CLI; WSL requires Windows interop and Windows-accessible paths.
license
MIT
metadata.version
2.3.0
metadata.author
十里 & FRIDAY
metadata.homepage
https://zipic.app
metadata.changelog
./CHANGELOG.md

Zipic

Image compression on macOS and Windows, 100% on-device. Drive the installed GUI via its CLI; URL Scheme is a fallback when the CLI is unavailable.

Platform and shell

Identify the OS, architecture and shell where commands execute, rather than the user's desktop OS. Keep the GUI, CLI and input/output paths on the same host and user account.

  • macOS: use zipic and POSIX shell syntax. If missing, run bash "<skill-dir>/scripts/detect.sh".
  • Native Windows: read reference/windows.md before setup or compression. Use PowerShell and zipic.exe; run & "<skill-dir>\scripts\detect.ps1" to resolve the executable and verify its version. The packaged CLI is ZipicCli.exe, exposed as the zipic.exe app execution alias; the GUI's Zipic.exe is a different executable.
  • WSL: there is no Linux Zipic binary. Use Windows PowerShell through WSL interop with paths converted by wslpath -w, following the Windows reference. A Linux container or remote Linux host without Windows interop cannot invoke the Windows GUI.

Resolve <skill-dir> from this loaded skill's location; script paths are not relative to the user's project. On Windows use & $exe for a resolved executable, $env:NAME for environment variables, quoted paths and argument arrays. Do not copy Bash continuations, open, brew or /tmp paths into PowerShell.

Compress

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

--json is required — parse stdout separately from stderr. Capture the process exit code immediately ($LASTEXITCODE in PowerShell), then inspect isError and every data.results[].state; exit 0 alone does not prove every file succeeded. Report per-file output_bytes, saved_pct and errors. Pass directories directly; Zipic walks them recursively.

NeedFlag
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
Lossless JPEG XL--format jxl --jxl-lossless (CLI ≥ 0.4.0; confirm in --help)

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.

bash
# 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

Lossless JXL (CLI ≥ 0.4.0): confirm zipic --help lists jxl-lossless before using it. On a CLI without the flag, the bare form swallows the next argument. Lossless sources become pixel-exact JXL and JPEGs are reversibly transcoded; already-lossy sources (lossy JXL/WebP, HEIC, AVIF, JPEG-in-TIFF) come back as state: "skipped" with skip_reason, with no output and the source untouched. Report skips separately from failures; re-run only those inputs with --no-jxl-lossless if the user accepts lossy, warning them that this often grows the file. Details: reference/cli.md → JXL lossless mode.

Exit codes: 0 request completed / 1 runtime — read error.code from JSON / 64 bad args (may be stderr only) / 65 GUI unavailable after auto-launch. pro_required returns upgrade/trial context in error.data (purchase_url, trial_available when present) — surface it, don't bypass. Format gates vary by platform; Windows uses ICO rather than macOS ICNS. Per-file quota/failure states must also be reported.

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

Show full SKILL.md (375 more words)Show less

When the CLI fails

On macOS, if zipic isn't on $PATH, or exit 65 persists after one retry, run from the skill directory:

bash
bash scripts/detect.sh

Read the route field:

routeAction
cliRe-run the CLI; it auto-launches Zipic and waits ~8 s for the socket.
install_cliCLI binary missing — tell user: Zipic menu bar → "Install zipic CLI". Use Fallback below for now.
url_schemeZipic < 1.9.5, no CLI exists — tell user to upgrade. Use Fallback below.
halt_no_appZipic not installed — suggest brew install --cask zipic or https://zipic.app.
halt_not_macosThis Bash detector is macOS-only. On Windows switch to scripts/detect.ps1; on WSL read the Windows reference.

On Windows, use the detection routes in reference/windows.md. There is no separate CLI installer: check the app execution alias and $env:LOCALAPPDATA\Microsoft\WindowsApps before reinstalling. The CLI auto-launches the packaged GUI and waits about 8 seconds; on persistent exit 65, open Zipic in the same user's desktop session and retry once. Do not repeatedly retry failed compression batches or run the GUI's executable as a CLI.

Fallback: URL Scheme

On macOS, use only when route is install_cli or url_scheme; on Windows, repair the alias first and use a URL only if CLI recovery is unavailable. URL Scheme has no result JSON or compression exit code. Load reference/url-scheme.md before constructing the URL: parameter names and semantics differ by platform (ratio is particularly different). Percent-encode paths, use a separate output directory and inspect actual files afterward. Launching the URL does not prove compression succeeded.

SVG and presets quick notes

  • SVG optimization (Pro; macOS Zipic ≥ 1.9.0, also supported on Windows): 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.

© okooo5km, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts) in skills/zipic of okooo5km/Skills4U.

  • SKILL.md
  • CHANGELOG.md
  • LICENSE
  • evals/evals.json
  • reference/cli.md
  • reference/resources.md
  • reference/url-scheme.md
  • reference/windows.md
  • scripts/detect.ps1
  • scripts/detect.sh

Open the folder on GitHubat commit 7ffd3a4

Compare with similar skills

Zipic next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Zipic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zipic this skillokooo5km/Skills4U183—~2.2kAutomated safety check: PassMIT
Remote Hostslibnativeapi/nativeapi162—~1.3kAutomated safety check: PassMIT
Local Asrysyecust/lecture-to-notes273—~1.6kAutomated safety check: PassCustom licence
Shell Toolingowent/libatbus235—~1.4kAutomated safety check: PassMIT
Oh My PoshJanDeDobbeleer/oh-my-posh24k—~319Automated safety check: PassMIT
Image Manipulation Image Magickgithub/awesome-copilot40k1 repos~1.7kAutomated safety check: NotesMIT

Similar skills

  • Remote Hosts

    libnativeapi/nativeapi

    Build, run, and GUI-test on another machine over SSH — the user's Windows laptop today, Linux or other macOS machines tomorrow — with one symmetric CLI for every OS: push scripts, run them either in…

    162 GitHub stars~1.3k tokensUpdated today
    MobileAuto-check passed
  • Local Asr

    ysyecust/lecture-to-notes

    把本地长视频/音频转写成文字稿 + 可选字幕,纯本地(不上传云端),用 sherpa-onnx X-ASR Zipformer transducer 模型(int8 量化、中英双语、自动标点)。已在 macOS Apple Silicon(int8 + AMX,~100× 实时)、Linux ARM64(CPU,~32× 实时)与 Windows(PowerShell…

    273 GitHub stars~1.6k tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-check passed
  • Shell Tooling

    owent/libatbus

    A skill your agent uses when: running terminal commands, writing or debugging shell/PowerShell scripts, choosing or installing CLI tools, or diagnosing command failures, quoting/escaping errors, or…

    235 GitHub stars~1.4k tokensUpdated 28 days ago
    DevelopmentAuto-check passed
  • Oh My Posh

    JanDeDobbeleer/oh-my-posh

    Install, configure, or troubleshoot Oh My Posh/ohmyposh: shell init, themes, segments, Nerd Font icons, and prompt setup on PowerShell, zsh, bash, or fish.

    24k GitHub stars~319 tokensUpdated today
    DevelopmentAuto-check passed
  • Image Manipulation Image Magick

    github/awesome-copilot

    Official

    Process and manipulate images using ImageMagick. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 1 repo~1.7k tokens
    Data & AnalyticsAuto-check: notes
  • Tapd Iteration Init

    TencentBlueKing/bk-bcs

    迭代执行流水线启动器。分三个阶段执行:信息检查(验证 git 环境、获取迭代信息、 解析迭代分支)→ 恢复检测(已有状态文件时判定恢复策略)→ 新流程初始化(创建分支、 迭代目录和 iteration-state.json)。

    841 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from okooo5km/Skills4U

All 8 skills in this repo
  • Grid25

    okooo5km/Skills4U

    25宫格选题助手(grid25)。帮用户为任意行业生成爆款内容选题关键词,渲染可交互的 25宫格抽签工具,并可直接搜索真实平台热门选题方向。

    183 GitHub stars~797 tokensUpdated 2 days ago
    Auto-check passed
  • Orchard

    okooo5km/Skills4U

    Use the local Orchard app to interact with macOS Apple apps and services: Calendar, Reminders, Clock, Mail, Contacts, Notes, Music, Weather, Messages, Location/Maps, and Apple Shortcuts.

    183 GitHub stars~5k tokensUpdated 2 days ago
    Auto-check: warnings
  • 中国软件著作权申请材料生成工具。申请表直接输出 Markdown 提交,源程序/用户手册/设计说明书三份生成 LaTeX 并编译为 PDF。自动分析项目代码,生成四份材料(前后各30页共60页源程序、含页眉页脚的用户手册和设计说明书、Markdown…

    183 GitHub stars~2.8k tokensUpdated 2 days ago
    Auto-check: notes
  • Sketch Image Prompt

    okooo5km/Skills4U

    Transforms article content or summaries into minimalist hand-drawn style JSON prompts for AI image generation tools.

    183 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Video Storyboard Designer

    okooo5km/Skills4U

    专业 AI 视频分镜设计师。当用户想要创作视频、制作分镜脚本、生成 AI 视频提示词、规划视频内容结构时,必须使用此 skill。

    183 GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Xiaohongshu Expert

    okooo5km/Skills4U

    小红书运营专家——从0到1全流程指导。覆盖账号定位、内容创作、标题优化、封面设计、SEO搜索优化、推荐算法拆解、涨粉策略、变现路径、数据分析、平台规则合规、内容发布前审核、账号健康度诊断等全维度。

    183 GitHub stars~931 tokensUpdated 2 days ago
    Auto-check passed

Questions about Zipic

What does Zipic do?

Local image compression and Zipic-app expert for macOS and native Windows. Zipic is an agent skill from okooo5km/Skills4U. Local image compression and Zipic-app expert for macOS and native Windows.

When should I use Zipic?

Zipic fits situations like: shrinking images; batch compression; conversion to WebP/AVIF/HEIC/JXL (including lossless JPEG XL); SVG optimization.

How do I install Zipic in Claude Code?

Run `npx skills add okooo5km/Skills4U --skill zipic -a claude-code`. Or copy the skill folder (skills/zipic in okooo5km/Skills4U) into .claude/skills/zipic in your project. Claude Code loads it when a task matches its description.

How do I install Zipic in Codex?

Run `npx skills add okooo5km/Skills4U --skill zipic -a codex`. Or copy the skill folder (skills/zipic in okooo5km/Skills4U) into .agents/skills/zipic in your project. Codex loads it when a task matches its description.

Can I use Zipic in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add okooo5km/Skills4U --skill zipic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zipic, .gemini/skills/zipic, .github/skills/zipic and .opencode/skills/zipic in your project.

What does Zipic need to run?

Going by SKILL.md and its folder, Zipic needs PowerShell and a shell for the scripts in its folder and the command-line tools its instructions call (bash and brew). Our summary lists: A Bash shell; PowerShell. Compatibility (from SKILL.md): macOS with Zipic.app >= 1.9.5 for CLI (>= 1.9.0 for SVG via URL Scheme), or Windows 10 build 19041+ / Windows 11 with packaged Zipic and its zipic.exe execution alias. Windows examples support PowerShell 5.1 and 7. No native Linux CLI; WSL requires Windows interop and Windows-accessible paths..

Does Zipic access the network?

SKILL.md names 1 domain. As links in the text: zipic.app. This is read from the text; nothing was executed.

Is Zipic safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Zipic use?

Zipic is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Zipic use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Zipic?

Skills that share tags, products or a category with Zipic: Remote Hosts (libnativeapi/nativeapi, 162 stars), Local Asr (ysyecust/lecture-to-notes, 273 stars), Shell Tooling (owent/libatbus, 235 stars) and Oh My Posh (JanDeDobbeleer/oh-my-posh, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zipic?

okooo5km (a GitHub user) maintains it in okooo5km/Skills4U, which has 183 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 7, 2026.

Source: okooo5km/Skills4U on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.