sprite-gen

Solid

Generate clean 2D game sprites and animation atlases with a component-row pipeline: base identity, numeric sprite-request SSoT, per-state layout guides, image-gen row strips, chroma-key alpha cleanup, connected-component frame extraction, cell-based atlas composition, QA reports, and runtime manifest frame_layout.

Web & Frontend 213 stars 20 forks Updated 5 days ago Apache-2.0

Install

View on GitHub

Quality Score: 94/100

Stars 20%
78
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Sprite Gen `sprite-gen` builds generic game sprite atlases with a `component-row` pipeline: ```text sprite-request.json -> layout guides + prompts -> image-gen state rows -> chroma alpha -> connected components -> transparent cells -> sprite-sheet-alpha.png + manifest.json.frame_layout ``` Use only the `component-row` pipeline. Do not treat one-shot master sheets, fixed-grid atlas cutting, local drawing, or static fallback as a successful sprite result. ## Script Map The skill uses scripts as explicit pipeline commands, not as hidden imports. Each script has one job: - `prepare_sprite_run.py` — prepare a run from request truth: write `sprite-request.json`, per-state layout guides, prompts, and empty `raw/` and `frames/` folders. - `extract_sprite_row_frames.py` — read generated `raw/<state>.png` strips, remove chroma background, extract connected sprite components, and write transparent frame PNGs plus `frames/frames-manifest.json`. - `compose_sprite_atlas.py` — compose extracted frames into `sprite-sheet-alpha.png` and runtime `manifest.json.frame_layout`. - `preview_animation.py` — build QA previews from extracted frames: contact sheets and state GIFs under `qa/`. - `compose_selected_cycle.py` — record a human-selected frame subset as an explicit selected-cycle manifest plus QA GIF/contact sheet. Reads `curation.json` selection/transform by default; explicit `--frames` overrides it. - `compose_sprite_gif.py` — export a clean transparent GIF from selected frame PNGs ...

Details

Author
aldegad
Repository
aldegad/sprite-gen
Created
1 months ago
Last Updated
5 days ago
Language
Python
License
Apache-2.0

Related Skills