前言¶
在自动化脚本、文档配图或交付物整理里，经常要把同一张图转成指定格式，或在不改画布比例的前提下调整输出格式参数。本地用命令行或桌面工具可以完成，但在 Cursor、Claude Code 等带 Skills 的 Agent 里，更省事的做法是把「读图路径、目标格式、批量规则」交给对话，由 Skill 约束调用方式。下面介绍 SkillHub 上的社区 Skill「修图」（@user_31b19f2b/imgmage），其公开说明聚焦在图片格式的修改与调整。
这是什么¶
「修图」是 SkillHub 分类 design-media 下的社区 Skill，坐标为 @user_31b19f2b/imgmage，当前页面标注版本 1.0.0，来源为 community，发布者为 user_31b19f2b。SkillHub 页面与 API 入口对能力的描述一致：修改图片格式，调整格式。页面同时带有标签 requires_api_key=true，表示启用后通常需要配置 API Key（具体键名与服务商以安装包内 SKILL.md 为准；公开页面未展开第三方服务名称，本文不臆测）。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_31b19f2b/imgmage
- API 坐标页：https://api.skillhub.cn/user_31b19f2b/imgmage
核心功能（已核实范围）¶
依据 SkillHub 公开文案与抓取元数据，可确认的能力边界如下：
- 格式相关处理：围绕「修改图片格式」「调整格式」——适合在对话中说明源文件、目标格式（如 PNG、JPEG、WebP 等，以 Skill 实际支持为准）及是否批量。
- 需 API Key：元数据标记
requires_api_key=true，安装后应先在 Agent 约定位置配置密钥，再发起修图任务。 - 通用 Skill 形态：遵循 SkillHub 常见的
SKILL.md包结构，由 Agent 在匹配用户意图时加载说明并执行其中步骤。
公开资料未列出裁剪、去背景、水印等细项；若安装后的 SKILL.md 另有能力说明，以本地安装内容为准。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装，或把官方提示词发给 Agent 让其按安装文档操作。
1. 安装 SkillHub 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. 将 Skill 装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不被加载。
skillhub install user_31b19f2b/imgmage --dir <你的 skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（Cursor）：
skillhub install user_31b19f2b/imgmage --dir ~/.cursor/skills/
3. 通过对话让 Agent 安装¶
SkillHub 页面提供的安装提示为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_31b19f2b/imgmage`。
将上述内容发给当前 Agent 即可；Agent 应按 skillhub.md 完成 CLI 检查与 --dir 安装。
安装完成后重启或刷新 Agent 的 Skills 加载（视各客户端文档而定），并按要求配置 API Key。
典型用法¶
在 Skill 已安装且 API Key 就绪的前提下，用法与多数 design-media 类 Skill 相同：用自然语言说明输入输出，由 Agent 选中「修图」并遵循 SKILL.md。
可复现的起步步骤：
- 确认
~/.cursor/skills/（或你使用的等价目录）下存在@user_31b19f2b/imgmage对应包。 - 在对话中写明本地图片路径、目标格式，以及是否需要对多张图批量处理。
- 若 Agent 询问密钥或环境变量，按
SKILL.md填写（公开页面仅标明需要 API Key，未给出字段名）。
示例请求（意图描述，非固定 API）：
使用修图 Skill：把 /path/to/photo.png 转为 JPEG，质量适中，输出到同目录 photo.jpg。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的环境，希望把「改格式、调格式」从手工点选菜单改为对话驱动。
- 愿意按 Skill 要求配置 API Key，并接受社区 Skill 由发布者维护的更新节奏。
限制与注意
- 公开描述较简：SkillHub 摘要只有格式修改与调整；复杂修图需求应先阅读安装后的
SKILL.md，确认是否覆盖。 - API Key：
requires_api_key=true表示无密钥时可能无法调用后端能力；勿把密钥写入仓库或聊天记录的公开片段。 - 社区来源：
source: community，质量与合规需自行评估；生产环境建议固定版本并留存安装包。 - 索引数据：抓取元数据显示分类 design-media，评分 100000、下载 1963、安装 0（页面统计会变动，以 SkillHub 实时显示为准）。
结尾¶
「修图」把图片格式修改与调整封装成 Agent Skill，适合在开发流程里用对话指定路径与目标格式，而不是反复打开独立修图软件。安装走 SkillHub 标准流程，并留意 API Key 与 SKILL.md 中的具体约束。
官方地址：https://www.skillhub.cn/skills/user_31b19f2b/imgmage
API 坐标：https://api.skillhub.cn/user_31b19f2b/imgmage
