Skip to content
SkillScript-led4,812 tokens in use

Sprite Gen

Turns one base image into a transparent sprite atlas with a frame manifest, or into seamless motion loops, using GPT or Grok image and video generation.

4,165 stars on the repository Apache License 2.0aldegad/sprite-gen
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \ --repo aldegad/sprite-gen --path . --name sprite-gen
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Sprite Gen costs

289tokens idle
4,812tokens in use
282,478tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/compose_selected_cycle.py, scripts/compose_sprite_atlas.py, scripts/compose_sprite_gif.py, scripts/cuda_lane.py, scripts/curation.py, scripts/dev/breathe_mutation_battery.py, scripts/dev/check_visible_magenta.py, scripts/dev/measure_align_sigma.py, scripts/dev/source_restoration_demo.py, scripts/diagnose_video_loop.py, scripts/export_aseprite.py, scripts/export_curated_pngs.py, scripts/extract_sprite_row_frames.py, scripts/gen_set.py, scripts/generate_sprite_image.py, scripts/generate_sprite_video.py, scripts/inspect_sprite_run.py, scripts/interpolate_frames.py, scripts/linux_lane.sh, scripts/prepare_sprite_run.py, scripts/preview_animation.py, scripts/recolor.py, scripts/release_notes.py, scripts/release_publish.py, scripts/run_correction_loop.py, scripts/score_sprite_run.py, scripts/serve_curation.py, scripts/slice_sheet_cells.py, scripts/unpack_atlas_run.py, scripts/video_canvas.py, scripts/video_frames.py, scripts/video_loop.py, scripts/video_set.py, sprite_gen/__init__.py, sprite_gen/_deps.py, sprite_gen/_modules.py, sprite_gen/background/__init__.py, sprite_gen/background/tile.py, sprite_gen/cli.py, sprite_gen/compose/__init__.py, sprite_gen/compose/compose_atlas.py, sprite_gen/compose/compose_cycle.py, sprite_gen/compose/compose_gif.py, sprite_gen/compose/export_aseprite.py, sprite_gen/compose/export_pngs.py, sprite_gen/curate/__init__.py, sprite_gen/curate/anchor.py, sprite_gen/curate/curation.py, sprite_gen/effects/__init__.py, sprite_gen/effects/anatomy.py, sprite_gen/effects/breath_beat.py, sprite_gen/effects/breathe.py, sprite_gen/effects/interpolate.py, sprite_gen/effects/recolor.py, sprite_gen/effects/reroll.py, sprite_gen/effects/shadow.py, sprite_gen/frames/__init__.py, sprite_gen/frames/alpha_floor.py, sprite_gen/frames/check_visible_magenta.py, sprite_gen/frames/cutout.py, sprite_gen/frames/decontam.py, sprite_gen/frames/extract.py, sprite_gen/frames/folder.py, sprite_gen/frames/logo_matte.py, sprite_gen/frames/measured_matte.py, sprite_gen/frames/segment.py, sprite_gen/frames/slice_sheet.py, sprite_gen/frames/unpack_atlas.py, sprite_gen/gen/__init__.py, sprite_gen/gen/address.py, sprite_gen/gen/anthropic_api.py, sprite_gen/gen/base.py, sprite_gen/gen/chroma.py, sprite_gen/gen/claude_login.py, sprite_gen/gen/codex_provider.py, sprite_gen/gen/facing.py, sprite_gen/gen/facing_vision.py, sprite_gen/gen/gen_set.py, sprite_gen/gen/grok_provider.py, sprite_gen/gen/handedness.py, sprite_gen/gen/logo.py, sprite_gen/gen/openai_provider.py, sprite_gen/gen/pixel_draw.py, sprite_gen/gen/pixel_gates.py, sprite_gen/gen/pixel_grid.py, sprite_gen/gen/prepare.py, sprite_gen/gen/prompt_parts.py, sprite_gen/gen/refusal.py, sprite_gen/gen/retry.py, sprite_gen/gen/video.py, sprite_gen/gen/xai.py, sprite_gen/qa/__init__.py, sprite_gen/qa/correction_loop.py, sprite_gen/qa/handed.py, sprite_gen/qa/holds.py, sprite_gen/qa/inspect.py, sprite_gen/qa/motion.py, sprite_gen/qa/preview.py, sprite_gen/qa/score.py, sprite_gen/scene/__init__.py, sprite_gen/scene/inspect_scene.py, sprite_gen/scene/model.py, sprite_gen/scene/render.py, sprite_gen/serve/__init__.py, sprite_gen/serve/composer/src/api.js, sprite_gen/serve/composer/src/boot.js, sprite_gen/serve/composer/src/canvas.js, sprite_gen/serve/composer/src/controls.js, sprite_gen/serve/composer/src/i18n.js, sprite_gen/serve/composer/src/library.js, sprite_gen/serve/composer/src/session.js, sprite_gen/serve/composer/src/ui.js, sprite_gen/serve/curator/src/atlas.js, sprite_gen/serve/curator/src/base-editor.js, sprite_gen/serve/curator/src/boot.js, sprite_gen/serve/curator/src/breathe.js, sprite_gen/serve/curator/src/cards.js, sprite_gen/serve/curator/src/chrome.js, sprite_gen/serve/curator/src/compare.js, sprite_gen/serve/curator/src/display.js, sprite_gen/serve/curator/src/gen-trigger.js, sprite_gen/serve/curator/src/i18n.js, sprite_gen/serve/curator/src/lasso-select.js, sprite_gen/serve/curator/src/persistence.js, sprite_gen/serve/curator/src/pipeline-tree.js, sprite_gen/serve/curator/src/progress.js, sprite_gen/serve/curator/src/recolor.js, sprite_gen/serve/curator/src/region-transform.js, sprite_gen/serve/curator/src/row-controls.js, sprite_gen/serve/curator/src/row-export.js, sprite_gen/serve/curator/src/status.js, sprite_gen/serve/curator/src/store.js, sprite_gen/serve/curator/src/tooltip.js, sprite_gen/serve/curator/src/transform-provider.js, sprite_gen/serve/curator/src/transforms.js, sprite_gen/serve/curator/src/tween.js, sprite_gen/serve/curator/src/util.js, sprite_gen/serve/curator/src/view-nav.js, sprite_gen/serve/curator/src/zones.js, sprite_gen/serve/curator/src/zoom-editor.js, sprite_gen/serve/serve_compose.py, sprite_gen/serve/serve_curation.py, sprite_gen/spec/__init__.py, sprite_gen/spec/assets.py, sprite_gen/spec/layout.py, sprite_gen/spec/migrate_breathe.py, sprite_gen/spec/migrate_request.py, sprite_gen/spec/runio.py, sprite_gen/spec/subject.py, sprite_gen/util/__init__.py, sprite_gen/util/cli_kwargs.py, sprite_gen/util/console.py, sprite_gen/util/gif_utils.py, sprite_gen/util/hexcolor.py, sprite_gen/util/lsq.py, sprite_gen/util/resample.py, sprite_gen/video/__init__.py, sprite_gen/video/align.py, sprite_gen/video/auto_motion.py, sprite_gen/video/batch.py, sprite_gen/video/body_plan.py, sprite_gen/video/body_turn.py, sprite_gen/video/cadence.py, sprite_gen/video/canvas.py, sprite_gen/video/chain.py, sprite_gen/video/clip_prompt.py, sprite_gen/video/compare.py, sprite_gen/video/crossings.py, sprite_gen/video/effect.py, sprite_gen/video/evidence.py, sprite_gen/video/face_bake.py, sprite_gen/video/face_layer.py, sprite_gen/video/face_pack.py, sprite_gen/video/face_plan.mjs, sprite_gen/video/facing.py, sprite_gen/video/follow.py, sprite_gen/video/follow_inspect.py, sprite_gen/video/frames.py, sprite_gen/video/gait_fallback.py, sprite_gen/video/held.py, sprite_gen/video/held_fill.py, sprite_gen/video/interpolation_quality.py, sprite_gen/video/legs.py, sprite_gen/video/local_cycle.py, sprite_gen/video/loop.py, sprite_gen/video/loop_vocab.py, sprite_gen/video/motion_anchor.py, sprite_gen/video/nonloop.py, sprite_gen/video/part_pop.py, sprite_gen/video/parts.py, sprite_gen/video/period.py, sprite_gen/video/play.py, sprite_gen/video/playback.py, sprite_gen/video/prop_plate.py, sprite_gen/video/repair.py, sprite_gen/video/restoration.py, sprite_gen/video/rife.py, sprite_gen/video/rife_install.py, sprite_gen/video/rife_torch.py, sprite_gen/video/root_motion.py, sprite_gen/video/set_sheet.py, sprite_gen/video/source.py, sprite_gen/video/sprite-gen-face-v1.mjs, sprite_gen/video/stop.py, sprite_gen/video/sway.py, sprite_gen/video/sway_inspect.py, sprite_gen/video/wrap_blend.py, sprite_gen/workflow/__init__.py, sprite_gen/workflow/access.py, sprite_gen/workflow/capabilities.py, sprite_gen/workflow/catalog.py, sprite_gen/workflow/guide.py, sprite_gen/workflow/preferences.py.

Touches

shelldetectednetworkdetectedwrites filesdetectedgitdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Fair
  • Frontmatter7/15
  • Structure8/25
  • Examples9/15
  • Output10/15
  • Size13/15
  • Resources1/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Fair
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    .githooks/pre-commit
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 59
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/cuda_lane.py, line 189
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/cuda_lane.py, line 315
  • Runs git commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/linux_lane.sh, line 207
  • File that was not read−5

    a file the skill ships that was not read, so what it does is unknown

    tests/fixtures/prepare-rows-v2.32.0.json.gz
  • File that was not read−5

    a file the skill ships that was not read, so what it does is unknown

    tests/fixtures/prompts-v2.22.0.json.gz

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community56
  • Maturity28
  • Momentum40

Sprite Gen drives image generation row by row from one base image, keeps the character consistent, removes the chroma background to real alpha, extracts each pose and bakes an atlas with a machine-readable manifest. It can also send a still to a video model and cut a transparent loop per motion state.

It covers the rest of a sprite workflow too: typography logos, standalone image-to-video clips, palette swaps, engine exports, repeating backgrounds, projected shadows, motion inspection and optional scene composition from finished assets. A curation view lets you compare, reject and nudge frames before baking.

What You Get

  • A transparent sprite atlas PNG and a manifest with frame rectangles, per-state fps and loop flags
  • Transparent GIF, WebP and strip loops per motion state, cut from video clips
  • Palette-swapped colourway sheets and Aseprite, Phaser or Flame exports
  • Typography logos cut out with their glow, with the lettering read back and misspellings refused
  • Repeating background tiles, projected shadows and motion or contact measurements

Common Use Cases

  • Producing a character atlas for a 2D game from one concept image
  • Animating a still into walk, run, jump and attack loops with transparent backgrounds
  • Making recolored variants of a finished sprite sheet
  • Cutting a title logo out of a generated title screen

What Makes It Unique

It is a full pipeline that follows the sprite from generation to engine export, with stages for chroma removal, loop cutting, held-frame repair and set alignment. The skill tells the agent never to replace an engine stage with a hand-made script and to name any stage done by hand. It also separates provider choices and billing: subscription logins come first, and API-key calls are billed per call and announced before they run.

Under The Hood

SKILL.md is a routing table that sends the agent to docs for each task, and the work is done by a Python package run from a virtualenv in the install folder. It runs shell commands including codex, grok, ffmpeg, img2webp, node and an optional RIFE frame interpolator that the skill can download once. It calls image and video providers over the network with your logins or API keys, some billed per call, and it writes run folders, atlases, GIFs and exports to disk. When codex cannot run, it stops and asks you which provider to use. The repository also ships developer scripts for remote test lanes that use git and the network, and a pre-commit hook that could not be read, so what it does is unknown.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers