Install the skill once, then ask your coding agent (Codex, Claude Code, …) to generate sprites, characters, and animations — it drives btelo-sprite for you.
Add the skill
curl -fsSL https://r2.btelo.com/sprite-cli/install.sh | sh
The command above installs the btelo-sprite CLI and drops the skill into your agent. Then sign in.
1Read the skill guide.
2Sign in at btelo.com and mint an API token.
3Start creating assets!
Works with any agent you use
CodexClaude CodeCursorWindsurfClineAntigravityOpenClawand more
Then just ask
Then ask your agent in plain language — it reads the skill and runs the CLI for you. For example:
“Generate idle, walk and attack sprites for this character.”
Run btelo-sprite yourself in the terminal or a script.
1 · Set up & sign in
Install the binary:
curl -fsSL https://r2.btelo.com/sprite-cli/install.sh | sh
Mint a personal token at btelo.com → Account → API tokens, then log in:
btelo-sprite login btu_live_xxxxxxxx
Check it works (prints your user and credit balance):
btelo-sprite whoami
2 · Generate sprites
Animate a character into a grid of actions — each action becomes one cell. The CLI downloads a sprite-sheet PNG plus a JSON describing the frame geometry.
Create a character image from text, then animate it — full-body, right-facing, plain background works best.
btelo-sprite char-gen \
--prompt "a chibi knight in blue armor, full body, plain background"
Tips
• Use --matting Fine for headless, transparent, hair-grade cutouts (browser tiers can't run from a CLI).
• Put shared art direction (camera, lighting, “no background”) in --style so the whole set stays consistent.
• Generation bills your btelo credits — check the balance with whoami before a big batch.
Output
Each sprite is a .png sheet on transparency plus a .json with frames, frameWidth, frameHeight, and columns — slice it at runtime and play the frames at the given fps. For pixel art, scale by integer factors with nearest-neighbor only.
