Agent Skills

装上 RouteMux 的 skills，让 Codex CLI、Claude Code、Cursor 用你的 API key 出图和生成视频。

Agent Skills 就是一些 SKILL.md 文件，用来教编程 agent 怎么做一件事。RouteMux 发布了四个，任何认这个开放格式的 agent 都能用：Claude Code、Codex CLI、Cursor、OpenCode 等。

源码：github.com/rootfily-ai/routemux-skills（MIT）。

为什么你可能需要出图那个

把编程 agent 的 base_url 指向任何第三方网关之后，它内置的出图工具就不工作了。 Codex CLI 的 $imagegen 是最典型的例子：它跟着厂商自己的订阅态走，不看你配的 base_url。

这不是配置错误，配置里也没有东西可修 —— 内置工具本来就是那么接的。解法是给 agent 一个直接打 HTTP 出图端点的 skill，那条路不受影响。

发布了哪几个

Skill	作用
`routemux-images`	出图、改图，落盘到你指定的路径
`routemux-video`	提交视频任务、轮询、下载结果
`routemux-models`	你这把 key 能调哪些模型、多少钱、支持什么
`routemux-setup`	把 Codex CLI / Claude Code / Cursor / Cline 等指到 RouteMux

安装

GitHub CLI

需要 gh 2.90 以上。

# 全装
gh skill install rootfily-ai/routemux-skills

# 只装一个
gh skill install rootfily-ai/routemux-skills routemux-images

# 装成全局而不是只对当前仓生效
gh skill install rootfily-ai/routemux-skills routemux-images --scope user

Claude Code

/plugin marketplace add rootfily-ai/routemux-skills
/plugin install routemux@routemux

手动

OpenCode 或其他读 skills 目录的工具：

git clone https://github.com/rootfily-ai/routemux-skills /tmp/routemux-skills
cp -r /tmp/routemux-skills/skills/* ~/.config/opencode/skills/
rm -rf /tmp/routemux-skills

设置 key

每个 skill 只读一个环境变量：

export ROUTEMUX_API_KEY='sk-...'

在控制台创建 key，并把这行写进 ~/.zshrc 或 ~/.bashrc，新开的终端才有。

key 只从环境变量读，不从别处读

这些 skill 不读 .env，不读你硬盘上任何凭据或配置文件，也绝不把 key 写进文件、日志或提交。它们唯一写到磁盘的东西是你要的那个产物，写在你给的路径上。没有 eval，不装 SDK，只有 curl 加一点 python3。每个脚本都短到能一口气读完 —— 我们也希望你真的读一遍。

然后直接说话就行

画一张折成一跳的世界地图，存到 ./hop.png

agent 会加载 routemux-images，从实时目录里挑一个出图模型，调 POST /v1/images/generations，把文件写下来。

几件值得知道的事

一次只出一张。 skill 不批量出变体。每张图单独计费，且预扣会随张数放大 —— 默认批量正好会把刚充了一点钱的人挡在门外。
模型名一律不写死。 skill 每次都查 /v1/models?capability=image_generation，因为 slug 会变 —— 这份文档自己就曾在当家型号换掉之后，写着过期的示例模型好几天。
可能由备用模型应答。 主出图上游不可用时，RouteMux 会改用别的出图模型应答而不是直接失败。计费跟随实际应答的模型，响应头里会写明是哪一个。
每把 key 有每日出图张数上限。 超出返回 RMX-LIMIT-4004，在 UTC 00:00 重置。