generate2dsprite

Generate and postprocess 2D game sprite sheets, animation grids, and transparent GIF exports.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill generate2dsprite-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate2dsprite
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/generate2dsprite
Command: npx skills add https://github.com/Chau165/local_skill --skill generate2dsprite-chau165

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve? Creating consistent, engine-ready 2D sprite animations is hard: AI-generated sheets often drift in scale, cross cell edges, or mix unrelated actions into unusable atlases. This Skill turns natural-language requests into structured sprite asset plans, generates raw sheets with built-in image generation on a solid magenta background, and deterministically postprocesses them into clean, aligned, QC-validated frames. ## Core Features & Use Cases - Asset Plan Inference: Automatically decides asset type, action, grid shape, and bundle structure (hero action bundles, spell bundles, prop packs, 4-direction walk sheets) from a plain-language request. - Deterministic Postprocessing: Chroma-key magenta cleanup, frame extraction, component filtering, scale-preserving alignment, strict QC metrics (body scale CV, anchor drift, edge touch), and transparent PNG/GIF export via local Python scripts. - Engine Integration: Emits Godot Sprite3D contracts and validated multi-action bundles with shared cross-action scale profiles so idle, run, and attack animations stay consistent. - Use Case: Ask for a side-view hero with idle, run, shoot, and jump animations; the Skill generates one QC'd grid sheet per action, keeps projectiles and muzzle flashes as separate FX sheets, and optionally assembles a final engine atlas. ## Quick Start Use the generate2dsprite skill to create a 2x2 idle animation sheet for a fire dragon creature with transparent background and GIF export.

Frequently Asked Questions about generate2dsprite

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a 2D sprite animation sheet for a game character?

Describe the character and actions in natural language; the Skill infers the grid shape, writes the image prompt, and generates a raw sheet on a solid magenta background. A local Python script then removes the background, extracts frames, aligns them, and exports transparent PNGs and a GIF.

How do I keep character scale consistent across idle, run, and attack animations?

Generate each action as a separate multi-row grid, then create one scale profile from the accepted idle or run sheet and apply it to all later actions during processing. The profile locks output cell size, scale, and anchor so actions cannot silently use different magnification.

Can generated sprite sheets be used in Godot?

Yes. Processing with a world-height parameter writes a godot-sprite3d.json contract with recommended pixel size, Sprite3D offset, frames, and timing. Multiple action contracts can be combined into a validated godot-sprite3d-bundle.json with loop and one-shot playback declarations.

Why do sprite frames cross cell edges or shrink in size?

Edge contact usually comes from single-row raw sheets or wide FX like slash arcs inflating the bounding box. Use multi-row grids for body actions, split wide effects into separate FX sheets, or reprocess with preserve scale strategy and feet alignment.

What are the limitations of AI-generated sprite sheets?

Raw single-row strips drift horizontally and are rejected for animated bodies, and mixed-action atlases cannot be generated reliably in one image. Each action must be generated and QC'd separately, with the final engine atlas assembled deterministically afterward.