A skill is a capability pack for coding agents (Claude Code, Cursor, Codex and friends). Once installed, just tell your agent "make me a vertical poster for a coffee shop" — it picks a sensible model, quotes the price first, generates, and hands you the file. You never memorise a model name or an API detail.
The recommended path is the Skills CLI (the skills.sh ecosystem — one command covers Claude Code, Cursor, Codex, Cline, Gemini CLI and 16+ other agents):
npx skills add stimQQ/apimodels-skill@apimodels-imageCareful: the skill name is apimodels-image (from SKILL.md), not the directory name. @image fails with “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 the image/ directory as the archive root (not the repo root), or claude.ai will not find SKILL.md.
After installing, have the agent run (or run yourself) the command below. It opens an apimodels.app authorization page; log in, click Authorize once, and a dedicated key named “CLI · date” is minted and delivered straight to this machine — nothing to copy-paste anywhere, and the key never appears in any chat, shell history or URL bar.
node ~/.claude/skills/apimodels-image/scripts/generate.mjs --loginVerify (it also shows your balance):
node ~/.claude/skills/apimodels-image/scripts/generate.mjs --checkTwo alternatives: if you already manage a key, set APIMODELS_API_KEY in your environment; on machines with no browser at all (CI, bare SSH) pipe the key in via --save-key. Revoke any key individually from the console whenever you like.
One habit worth keeping: never paste a key into an AI conversation — what enters the chat enters the transcript. The --login flow above exists precisely so you never have to.
No ceremony needed — once installed, just ask in natural language. The skill holds the agent to these rules:
| You say | The agent does |
|---|---|
| “Make a 2K product shot with crisp text” | Picks gpt-image-2 ($0.03 at 2K, best small text), quotes, then generates |
| “Fuse these two references into one poster” | Picks a multi-reference model and says why in one line |
| “Batch 8 storyboard drafts” | Anything ≥5 images: total cost first, generates only after you confirm |
| “Upscale this to 4K” | Uses the Real-ESRGAN upscaler — no repainting |
npx skills update (CLI installs); manual installs re-run the clone + cp.Video (Seedance, Kling, VEO, MiniMax Hailuo) and audio (ElevenLabs, Suno, MiniMax) skills are planned — same repository, same install.