Agnes Image Gen — Development skill for Claude Code

agnes-image-gen

Agnes Image 2.1 Flash 图像生成 skill，支持文生图、图生图和多图合成。

官方文档：https://www.agnes-ai.com/

快速安装（小白版）

你有两种方式把这个技能装到自己的电脑上，任选其一。

方式一：直接下载 `.skill` 压缩包（最简单）

1. 下载文件：dist/agnes-image-gen.skill（点它 → 右上角"下载"按钮，或者右键另存为）
2. 找到你电脑上的技能文件夹，一般是 ~/.agents/skills/（~ 就是你自己的用户主目录）
3. 把这个 .skill 文件解压到技能文件夹里：
   • Windows：右键 → 解压到当前文件夹（Windows 自带的解压就能打开，它本质是一个 zip 压缩包）
   • macOS：双击，或用"归档实用工具"打开
   • Linux：运行 unzip agnes-image-gen.skill -d ~/.agents/skills/
4. 解压后，你应该能看到 ~/.agents/skills/agnes-image-gen/SKILL.md 这个文件
5. 重启你的 AI 工具，技能就能用了

方式二：直接克隆整个仓库（适合会 Git 的人）

git clone https://github.com/VastFuture/agnes-image-gen.git ~/.agents/skills/agnes-image-gen

`.skill` 文件是什么？（小白必读）

`.skill` 就是一个**技能压缩包**，本质是一个 zip 压缩包，只是文件后缀叫 `.skill` 而已。

它把一整个技能文件夹（`SKILL.md` + 脚本 + 文档 + 示例图）打包成一个文件，方便你**下载、复制、发给别人、备份迁移**。

打个比方：

• 技能文件夹 = 一套已经组装好的乐高玩具
• .skill 文件 = 把乐高装进盒子里打包好，方便运输
• 收到盒子的人拆开，就得到一套完整的技能

里面装了什么东西？

agnes-image-gen.skill
├── SKILL.md                    技能说明书（AI 靠它知道怎么用）
├── scripts/generate.py         生图脚本（真正干活的东西）
├── references/                 详细文档（API 参数、提示词指南）
└── assets/                     示例图片（看看能生成什么效果）

使用前需要准备什么？

需要两个前提条件：

1. 技能加载路径：确保你的 AI 工具会从 ~/.agents/skills/ 加载技能（这是 opencode / Claude Code 等工具的通用约定）。
2. API Key：生图需要调用 Agnes AI 的服务，要设置一个环境变量 AGNES_API_KEY：
   • 从 https://www.agnes-ai.com/ 获取你的 API Key
   • 在终端里设置：export AGNES_API_KEY="你的key"（临时生效），或写进 shell 配置文件永久生效

怎么用这个技能？

装好之后，直接对你的 AI 助手说：

• "帮我生成一张图片，主题是……"
• "把这个图换成赛博朋克风格"
• "生成一张产品海报"

AI 会自动调用这个技能帮你生图。也可以手动运行脚本：

python3 scripts/generate.py "A cat astronaut on the moon" --size 2K --ratio 16:9 -o output.png

常见问题

**问：`.skill` 文件打不开？** 答：它本质是 zip。如果双击打不开，试试改后缀为 `.zip` 再解压，或用命令行 `unzip`。

**问：解压到哪里才对？** 答：解压到 `~/.agents/skills/` 下面，确保最终路径是 `~/.agents/skills/agnes-image-gen/SKILL.md`。

**问：装好了但是用不了？** 答：先检查 `AGNES_API_KEY` 有没有设置成功，输入 `echo $AGNES_API_KEY` 看看有没有输出你的 key。

**问：这个仓库和 `.skill` 文件有什么区别？