前言¶
文档配图、前端资源、接口返回的截图，体积一大就会拖慢构建、占满仓库配额，或让页面首屏变慢。手工在图形工具里一张张调质量、转格式，再对比肉眼清晰度，既慢又难在团队里复用同一套参数。把「分析图片特征 → 选策略 → 输出更小文件」交给带 Skill 的编码 Agent，可以在对话里直接处理本地路径，减少反复切工具的成本。
下面介绍 SkillHub 社区技能「智能图片压缩」的定位、能力与安装方式。
这是什么¶
「智能图片压缩」是 SkillHub 上的社区技能（坐标 @user_72991e7a/smart-image-compressor，当前版本 1.0.3，分类 dev-programming，发布者 user_72991e7a）。它面向 Agent 场景：在技能说明中约定使用 Python Pillow 对 PNG / JPG / WebP 做压缩，并在清晰度基本不变的前提下，将体积压缩到约 70% 左右（为技能页自述效果，实际比例因原图而异）。
技能标签标明 requires_api_key=false，不依赖额外 API Key。触发侧依赖自然语言关键词，例如「压缩图片」「图片太大」「缩小图片」「优化图片体积」「图片变小」等。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_72991e7a/smart-image-compressor
- API 元数据地址：https://api.skillhub.cn/user_72991e7a/smart-image-compressor
核心功能¶
根据 SkillHub 与抓取资料，已核实的能力如下。
- 格式覆盖：处理 PNG、JPG、WebP。
- 策略选择：自动分析图片特征后选用合适手段，包括 JPEG 质量调优、PNG 调色板优化、WebP 转换、等比例缩放等（具体组合由 Agent 按技能指引执行，而非固定单一参数表）。
- 对话触发：用户用上述关键词描述需求时，Agent 应加载该 Skill 并走压缩流程。
- 实现依赖：技能说明指向 Pillow，运行环境需能安装并调用 Python 与 Pillow（版本以你本机/项目环境为准，技能页未绑定单一 Pillow 版本号）。
SkillHub 侧统计（以抓取资料为准）：评分 100000，下载 1343 次。
安装与启用¶
安装分两种方式：用 SkillHub CLI 装到当前 Agent 的 skills 目录，或把官方提示词发给 AI 让其按安装文档操作。
方式一：SkillHub CLI¶
先确认是否已安装 skillhub（完整步骤见 SkillHub 安装与优先源配置）：
command -v skillhub && skillhub --version
未安装时可按官方文档执行推荐的一键安装（需本机可访问安装脚本地址）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能识别不到。
skillhub install @user_72991e7a/smart-image-compressor --dir <你的 Agent skills 目录>
常用客户端 skills 目录（摘自 SkillHub 安装文档，以你实际环境为准）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
装好后按你所用客户端的要求刷新或重启 Agent，使新 Skill 生效。
方式二：提示词安装¶
SkillHub 页面提供的安装提示大意如下：让 AI 阅读 https://skillhub.cn/install/skillhub.md，并安装 @user_72991e7a/smart-image-compressor。适合已习惯用对话完成 Skill 管理的场景。
典型用法¶
官方资料未给出独立 CLI 子命令示例；用法以「对话 + Agent 执行 Pillow 流程」为主。可复现的交互方式如下。
- 确认技能已安装到当前 Agent 的 skills 目录并已启用。
- 在对话中说明目标文件路径与诉求，并带上触发语，例如：「这张图太大了，帮我在保持清晰的前提下压缩一下，
/path/to/image.png」。 - Agent 按 Skill 指引分析图片并选择 JPEG 质量、PNG 调色板、WebP 转换或等比例缩放等策略，输出压缩后的文件（覆盖或另存路径以 Agent 与你确认的结果为准）。
若需批量处理，可在同一会话中列出多个路径或说明目录范围；是否支持批处理、是否备份原图，取决于 Agent 对 SKILL.md 的落实方式，建议在首次使用时明确要求「先备份」或「输出到新文件名」。
适用场景与注意¶
适合谁
- 在 Cursor、Claude Code、Codex 等支持 Skills 的环境里写代码、做文档的同学，需要快速减小配图或静态资源体积。
- 希望压缩逻辑跟对话上下文绑定（例如只对某次 PR 里的几张图处理），而不是单独维护一套图形界面预设。
限制与注意
- 压缩比例与观感因原图分辨率、透明通道、是否已有损压缩而异，「约 70%」是技能自述目标，不是对每张图的保证。
- 依赖 Python 与 Pillow；CI 或无 Python 的纯前端环境需自行准备运行条件，或改在本地 Agent 会话中执行。
- 涉及覆盖原文件时，建议先让 Agent 写到新路径或自行备份，避免误删唯一原件。
- 技能来源为 community，升级与行为变更以 SkillHub 上 v1.0.3 及后续版本为准，安装前可在 SkillHub 页核对简介与坐标。
结尾¶
「智能图片压缩」把 Pillow 侧的格式与策略选择写进 Agent Skill，用自然语言触发即可处理 PNG/JPG/WebP，适合在开发流程里顺手做体积优化。安装与坐标以 SkillHub 为准：
https://www.skillhub.cn/skills/user_72991e7a/smart-image-compressor
