Skill 是给编码 agent(Claude Code、Cursor、Codex 等)的能力包:装上之后,直接对 agent 说「画一张竖版咖啡店海报」,它会自己挑合适的模型、先告诉你花多少钱、生成、把文件交给你 —— 你不需要记任何模型名或 API 细节。
推荐走 Skills CLI(skills.sh 生态,一条命令覆盖 Claude Code、Cursor、Codex、Cline、Gemini CLI 等 16+ 种 agent):
npx skills add stimQQ/apimodels-skill@apimodels-image注意:技能名是 apimodels-image(来自 SKILL.md),不是目录名 image。写成 @image 会报 “No matching skills found”。
git clone https://github.com/stimQQ/apimodels-skill
cp -r apimodels-skill/image ~/.claude/skills/apimodels-imagecd apimodels-skill && zip -r apimodels-image.zip image -x '*.DS_Store'
# claude.ai → Settings → Capabilities → 开启 Code execution
# → Customize → Skills → + Create skill → 上传 zipzip 要以 image/ 目录为根打包(不是仓库根目录),否则 claude.ai 识别不到 SKILL.md。
装完后让 agent 跑(或自己在终端跑)下面这条命令。它会打开一个 apimodels.app 授权页,你登录后点一下「授权」,一把名为「CLI · 日期」的专属 key 就会自动创建并写进这台电脑 —— 全程不需要复制粘贴任何密钥,key 也不会出现在对话、终端历史或浏览器地址栏里。
node ~/.claude/skills/apimodels-image/scripts/generate.mjs --login验证一下(会顺便显示余额):
node ~/.claude/skills/apimodels-image/scripts/generate.mjs --check两个备选:已经有 key 的老用户可以直接设环境变量 APIMODELS_API_KEY;完全没有浏览器的机器(CI、纯 SSH)用 --save-key 从标准输入喂 key。不再用的 key 随时可在控制台单独删除。
安全习惯:永远不要把 key 粘贴进和 AI 的对话里 —— 进了对话就进了记录。上面的 --login 流程正是为了让这件事从此不再必要。
不需要任何仪式感 —— 装好后用自然语言提需求即可。技能会让 agent 遵守这些约定:
| 你说 | agent 做 |
|---|---|
| 「做一张 2K 的产品图,文字要清楚」 | 选 gpt-image-2($0.03/2K,小字最稳),先报价再生成 |
| 「把这两张参考图融成一张海报」 | 选支持多参考图的模型,说明选择理由 |
| 「批量出 8 张分镜草图」 | ≥5 张必先报总价、等你确认才动手 |
| 「这张图放大到 4K」 | 走 Real-ESRGAN 放大链路,不重绘内容 |
npx skills update(skills CLI 安装的);手动安装的重跑一遍 clone + cp。视频技能(Seedance、Kling、VEO、MiniMax Hailuo)与语音技能(ElevenLabs、Suno、MiniMax)在计划中,会进同一个仓库、同一种安装方式。