前言¶
博客配图、设计稿导出、前端资源打包时，常见需求是把 JPEG、PNG、WebP 压到可接受体积，或统一格式、批量处理、按尺寸缩放。自己写脚本可以，但每次都要回忆 Pillow 参数、处理透明通道和批量路径，成本不低。下面介绍 SkillHub 上的社区 Skill image-compress：把「压缩、转格式、批量、缩放」收敛成 Agent 可遵循的能力说明，在对话里直接交代任务即可。
这是什么¶
image-compress（坐标 @user_13f0f8f8/image-new，版本 1.0.0）是 SkillHub 分类 design-media 下的社区（community）技能，由发布者 user_13f0f8f8 提供。官方简介写明：使用 Python Pillow 压缩 JPEG、PNG、WebP，并支持质量调节、格式转换、批量处理与缩放。标签 requires_api_key=false，不依赖额外 API Key。
SkillHub 页面：https://www.skillhub.cn/skills/user_13f0f8f8/image-new
API 元数据地址：https://api.skillhub.cn/user_13f0f8f8/image-new
核心功能¶
以下能力均来自官方简介，未在资料中出现的参数或脚本名不展开：
- 格式：JPEG、PNG、WebP 的读取与输出。
- 质量调节：按目标体积或画质要求调整压缩质量（具体默认值以技能包内 SKILL.md 为准）。
- 格式转换：例如 PNG 转 WebP、JPEG 转 WebP 等常见链路。
- 批量处理：对目录或多文件一次性处理，适合资源目录整理。
- 缩放（resizing）：在压缩前或压缩时调整分辨率，便于缩略图或固定宽度导出。
实现依赖 Pillow；运行环境需已安装 Python 及对应依赖（安装技能后 Agent 通常会按技能说明安装或提示安装）。
安装与启用¶
SkillHub 提供两种常见方式：用 skillhub CLI 装到当前 Agent 的 skills 目录，或把安装提示交给 AI 按官方文档执行。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
2. 安装 image-compress¶
安装技能时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认落在 ./skills/，Agent 可能识别不到。
skillhub install @user_13f0f8f8/image-new --dir <你的 skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在 SkillHub 技能页将下列提示发给 AI，让其按 https://skillhub.cn/install/skillhub.md 安装 @user_13f0f8f8/image-new：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_13f0f8f8/image-new`。
安装或更新技能后，若 Agent 未加载新技能，按你所用客户端说明重启或刷新会话。
典型用法¶
公开页面未附带独立命令行工具说明；该技能属于通用 SKILL.md 格式，用法是在启用技能后，用自然语言描述输入路径、目标格式、质量与尺寸。下面是与官方能力描述一致的对话式示例（Agent 会按技能包内步骤生成或执行 Pillow 脚本）：
- 单张压缩：「把
/path/to/photo.jpg压到约 200KB，输出为 WebP，质量尽量保持可读。」 - 格式转换：「将
assets/icons/下所有 PNG 转为 WebP，保留透明通道。」 - 批量 + 缩放：「批量处理
dist/images/里的 JPEG/PNG：最长边不超过 1920，导出 WebP，质量 85。」
执行前确认源文件路径可访问；批量任务建议先对少量文件试跑，再全量处理。
适用场景与注意¶
适合谁：需要在 Cursor、Claude Code、Codex 等环境里做配图压缩、静态资源瘦身、格式统一的开发者或内容作者；不想每次手写 Pillow 样板代码时。
注意：
- 无损与有损策略因格式而异（例如 PNG 与 JPEG），极端压缩可能带来可见伪影，应用质量参数前先看小样。
- 批量覆盖原文件有风险，宜输出到新目录或先备份。
- 社区技能，行为以技能包内 SKILL.md 与 Pillow 版本为准；SkillHub 页面上评分与下载量会变动，撰写时页面显示评分为 100000、下载 714 次（以你打开 SkillHub 时的数据为准）。
结尾¶
image-compress 把 JPEG / PNG / WebP 的压缩、转格式、批量与缩放收敛到一条 Agent 技能里，依赖 Pillow、无需 API Key，适合在日常开发流程里处理图片资源。安装与坐标以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_13f0f8f8/image-new
- 坐标：
@user_13f0f8f8/image-new - 安装文档：https://skillhub.cn/install/skillhub.md
