Repolode
Submit
0x0funky

0x0funky/agent-sprite-forge

An agent skill that turns one approved character still into a full set of game-ready 2D sprite animations, with transparent PNG frames and GIF/WebM/Godot/Aseprite exports.

View on GitHub
Stars
5,312
Forks
517
Open issues
14
Last commit
21 hours ago

What is it?

Agent Sprite Forge is a set of agent skills for Claude Code, Codex and Grok that generates 2D game sprites. The workflow starts with a master still of a character, which the user approves. The agent then produces one image-to-video clip per action (idle, walk, run, attack, jump, hurt), and deterministic Python tools key out the background, register frames, pick loops, retime one-shot actions, and package the results.

Image and video generation is routed through a single script that uses configured API keys for OpenAI, Google Gemini, xAI, BytePlus or fal.ai, falls back to a signed-in Codex or Grok CLI, and finally to code-drawn pixel art. Each clip passes quality gates for area, feet, identity, and colour drift before it is accepted.

Outputs include animation.json with a PNG atlas, VP9-alpha WebM and packed-alpha MP4, Godot SpriteFrames, and Aseprite JSON. The project also includes a map generator that exports to Tiled, Godot 4 and LDtk.

Key features

  • 01Generates a whole action set from one approved master still.
  • 02Keys backgrounds with a soft matte and registers frames so body scale stays stable.
  • 03Picks walk, run and idle loops by measurement and retimes one-shot actions.
  • 04Offers an HD finish by default and a pixel-art finish with limited palette.
  • 05Exports animation.json with a PNG atlas, WebM alpha, packed MP4, Godot and Aseprite files.
  • 06Routes generation through configured API providers, local Codex or Grok CLIs, or code-drawn art.

Use cases

  • Creating character animations for a 2D platformer or action game from a single concept image.
  • Producing sprite sheets and frame-based animations for Godot or Aseprite projects.
  • Prototyping a game with generated characters, FX and tile-based maps.
  • Building a web game that plays transparent WebM or packed-alpha MP4 animations.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/0x0funky/agent-sprite-forge.git
  2. 2

    Enter the project folder

    cd agent-sprite-forge
  3. 3

    Install the Python dependencies

    python -m pip install -r requirements.txt
  4. 4

    Install the skills for Codex

    python tools/install_skills.py --apply --host codex

Things to know

  • Video generation needs ffmpeg 5.1 or newer on PATH.
  • Image and clip generation needs either a paid provider API key or a signed-in Codex or Grok CLI.

In collections

AI coding assistants & agentsAI agent skill librariesGame development tools & engines

Topics

#agent-skills#pixel-art#sprite-generation#game-development#image-to-video#animation#godot#aseprite#codex#sprite-generator

FAQ

What is agent-sprite-forge?
An agent skill that turns one approved character still into a full set of game-ready 2D sprite animations, with transparent PNG frames and GIF/WebM/Godot/Aseprite exports. Agent Sprite Forge is a set of agent skills for Claude Code, Codex and Grok that generates 2D game sprites. The workflow starts with a master still of a character, which the user approves. The agent then produces one image-to-video clip per action (idle, walk, run, attack, jump, hurt), and deterministic Python tools key out the background, register frames, pick loops, retime one-shot actions, and package the results.
Is agent-sprite-forge free to use? What license does it have?
agent-sprite-forge is open source under the MIT license. Check the license terms before using it in commercial products.
Is agent-sprite-forge still maintained?
Actively maintained. The last commit to agent-sprite-forge was on Nov 6, 2026.
What can I use agent-sprite-forge for?
Creating character animations for a 2D platformer or action game from a single concept image. Producing sprite sheets and frame-based animations for Godot or Aseprite projects. Prototyping a game with generated characters, FX and tile-based maps. Building a web game that plays transparent WebM or packed-alpha MP4 animations.
How do I install agent-sprite-forge?
Clone the repository: git clone https://github.com/0x0funky/agent-sprite-forge.git Enter the project folder: cd agent-sprite-forge Install the Python dependencies: python -m pip install -r requirements.txt Install the skills for Codex: python tools/install_skills.py --apply --host codex
Where can I get agent-sprite-forge?
The source code and installation instructions are on GitHub: https://github.com/0x0funky/agent-sprite-forge

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects