1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | image-manipulation-image-magick-github-awesome-copilot(SKILL.md 内 name:image-manipulation-image-magick) | — |
| 作者/维护者 | 贡献者 James Montemagno(GitHub 账号 2012 年注册,资料页标注任职 Microsoft),经 GitHub 官方合集 github/awesome-copilot 合并(PR #504) | GitHub API |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/image-manipulation-image-magick | — |
| 许可证 | MIT(仓库级) | GitHub API |
| GitHub Stars / Forks | 39,843 / 5,087(属整个 awesome-copilot 合集仓库,不代表本技能自身热度) | GitHub API |
| 最新版本 | 无独立版本号;技能于 2025-12-19 首次提交,2026-01-21 最近一次改动(技能名与目录名对齐) | GitHub API(按路径过滤的提交记录) |
| 安装方式 | gh skills install github/awesome-copilot image-manipulation-image-magick(需 GitHub CLI),或手动复制 skills/image-manipulation-image-magick 目录到本地 skills 目录;另需本机装有 ImageMagick |
仓库文档 |
2. 功能介绍与亮点
这是一份教 agent 用 ImageMagick(magick 命令)处理图片的技能,整个目录只有一个约 7 KB 的 SKILL.md,纯提示词、没有附带脚本。
- 图片信息读取:取单张或批量图片的宽高、格式、色彩空间等元数据(
magick identify)。 - 缩放与缩略图:单张或批量按指定尺寸缩放,保持长宽比;文中示例是把 2560×1440 壁纸批量缩成 427×240 缩略图。
- 按条件批处理:先读尺寸,再只处理满足条件的图片,避免无谓操作。
- 跨平台双套示例:每个任务同时给 PowerShell(Windows)与 Bash(Linux/macOS)写法,含检测
magick是否可用并提示安装命令的片段。 - 版本差异提示:注明 ImageMagick 6.x 旧系统需用
convert代替magick。
3. 适用场景
固定分类:文档与办公自动化
适合需要让 agent 批量处理本地图片文件的人:运营/行政批量压缩缩放素材,开发者给文档站、博客生成缩略图,设计或内容人员统一整理一批壁纸/截图的尺寸与格式。它处理的是图片文件本身的转换与整理,不涉及图片生成或设计创作。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——遵循 Agent Skills 规范(SKILL.md + YAML front matter),复制到
.claude/skills/即可加载。 - Codex CLI:⚠️ 需适配——Codex 不会自动扫描
~/.codex/skills,需在会话中手动引用 SKILL.md 内容。 - OpenClaw:❓ 未验证——未查到官方文档说明其对第三方 SKILL.md 的加载方式。
- Hermes Agent:✅ 原生支持——Hermes 按 tap 路径扫描子目录探测 SKILL.md,兼容标准 Agent Skills 规范。
- 所有 Agent 的共同前提:本机必须已安装 ImageMagick 并能在 PATH 中调用
magick。
5. 推荐理由
让 agent 自己写 ImageMagick 命令很常见,但容易在 magick/convert 版本、Windows 与 Unix 引号写法上翻车。这个技能把检测可执行文件、读尺寸、缩放、批量循环的可用写法固化下来,并明确提醒“路径加引号”“先读尺寸再处理”等习惯。对经常批量处理图片、又不想每次重新调命令行参数的人,它省掉的是反复试错;ImageMagick 本身是成熟的开源工具,技能没有额外引入任何新的运行时依赖。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 独立目录站 skills.sh 显示该技能累计安装约 9.6K 次(2026-01-22 首次出现);合集仓库 stars 不代表本技能自身热度 |
| 可用性 | 7 | 需先自行安装 ImageMagick,装好即用;文档含前置条件、双平台示例、指南与限制说明;覆盖面较窄(主要是读尺寸与缩放),最近一次改动在 2026-01 |
| 安全性 | 9 | 纯提示词,无附带脚本;示例命令均为本地图片处理,无联网外发,无凭据;License 明确 |
安全检查清单:①示例命令为本地 shell(magick、循环),范围仅限用户指定目录的图片,未见 rm、覆盖原图或 sudo 执行(仅在提示语里给出 apt 安装建议) ②运行时无联网外发 ③不需要 API key 或凭据 ④SKILL.md 未见可疑指令或夹带推广 ⑤贡献者为 Microsoft 员工,合集为 GitHub 官方仓库,信誉良好 ⑥License 明确(MIT) ⑦合集仓库近日仍有提交,该子技能最近改动 2026-01。skills.sh 上 Gen Agent Trust Hub、Socket、Snyk 三项审计均为 Pass。综合 = 三项均值。
7. 跟同类做法相比的优势
| 做法 | 定位 | 与本技能的差异 |
|---|---|---|
| 让 agent 临时手写 ImageMagick 命令 | 零准备,靠模型记忆 | 容易混淆 magick/convert 版本和 PowerShell/Bash 引号写法;本技能给出已整理好的双平台写法与版本提示 |
| Python Pillow 脚本 | 编程式处理图片,灵活度高 | 需要写和维护脚本、装 Python 库;本技能直接调用系统命令行,适合一次性批量任务,复杂合成/像素级处理不如脚本灵活 |
| 图形化批处理软件 | 手动点选,门槛低 | 无法嵌入 agent 流程;本技能让 agent 在对话中完成同类批量缩放 |
| 直接读 ImageMagick 官方文档 | 覆盖最全 | 需自行筛选命令;本技能只收录最常用的读取与缩放场景,覆盖窄但上手快 |
8. 用户评价
该技能目前在第三方平台尚无具名用户使用评价。可核实的公开痕迹:该技能由 PR #504 合入 github/awesome-copilot;skills.sh 显示累计安装约 9.6K 次。以上是采用数据,不是使用者评价。
9. 其他补充
后续一次提交把技能的 name 字段与目录名改成一致,修复了部分安装器按目录名识别时的不匹配问题。
10. 安装使用方式
# 先安装 ImageMagick(macOS 示例)
brew install imagemagick
# Ubuntu/Debian: sudo apt install imagemagick
# 安装技能(需 GitHub CLI)
gh skills install github/awesome-copilot image-manipulation-image-magick
也可手动把 skills/image-manipulation-image-magick 目录复制到 ~/.claude/skills/。装好后无需重启新会话即可触发:对 agent 说“把这个文件夹里的图片批量缩成 427x240 缩略图”即可。
11. 注意事项
- 依赖本机 ImageMagick 7(
magick);旧版 6.x 需改用convert。 - 覆盖面窄:只有读取信息、缩放、按尺寸批处理三类示例,不含裁剪、水印、格式压缩参数等进阶用法。
- 批量缩放默认写到新目录;若让 agent 改用
mogrify等原地覆盖命令,请先备份原图。 - 大批量处理可能占用较多内存。