sprite-gen
Generate clean 2D game sprites & animation atlases β component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
Install / Use
npx skills add aldegad/sprite-genInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of sprite-gen
sprite-gen scores 77/100 on our quality scale, 2541st of 2,790 Automation skills we index.
Its SKILL.md is 22 KB long, well organised into 8 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has no GitHub stars yet, so there is no community track record; judge it on its content.
Maintenance, license and trust
- The repository was last updated 9 days ago, so sprite-gen is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
sprite-gen compared with similar skills
All 4 of these similar skills score higher than sprite-gen; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| sprite-gen (this skill)by aldegad | 77 | 0 | 9d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install sprite-gen?
- Run
npx skills add aldegad/sprite-gen. The install tabs above show the steps for each supported agent. - Which AI agents does sprite-gen work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is sprite-gen safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is sprite-gen still maintained?
- The repository was last updated 9 days ago, so sprite-gen is actively maintained.
Skill content
View source on GitHubname: sprite-gen
version: 4.3.0
description: "Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation. Handles sprite requests, ordinary image generation/editing, typography logos (λ‘κ³ , νμ΄ν¬κ·ΈλνΌ, νμ΄ν κΈμ, νμ΄ν λ‘κ³ , wordmark, logo, title lettering: a title screen drawn with the title in it, its lettering lifted out transparent), standalone image-to-video clips (i2v, animate this still, κ·Έλ‘ μμ, μ΄λ§€μ§ λΉλμ€, μ€νΈ μμ§μ¬μ€, first/last frame, reference-to-video, μμ μ΄μ΄λΆμ΄κΈ°, μμ νΈμ§, extend/edit a clip), clips from a video MCP on the agent (ZCRE, μ§ν¬ MCP), chroma removal, animation atlases, video loops, νλ μ΄μ
λ·°, image candidates, νλ νΈ μ€μ, palette swap, recolor, engine exports, repeating backgrounds, projected shadows, talking face layers over body motions (λ§νλ μΌκ΅΄, μ
λ§μΆκΈ°, μΌκ΅΄ μΈ΅, lip sync, face pack), motion/contact inspection and optional scene composition from existing assets."
license: Apache-2.0
depends_on:
required_bins:
- name: codex
why: "gen --provider codex (image_gen via ChatGPT OAuth)"
- name: ffmpeg
why: "video-frames (clip -> frames) and video-set"
- name: img2webp
why: "video-loop WebP with exact alpha (libwebp); Pillow's animated writer drops -exact"
- name: node
why: "face-bake: the face pack's player (sprite-gen-face-v1.mjs) picks the frames"
- name: rife-ncnn-vulkan
why: "video-loop jump repair, held-cell fill and video-cycle-align (RIFE v4.25 in-betweens, no test-time augmentation, each image padded to 128; TNTwise's rife-ncnn-vulkan release 20250112). Install once with sprite-gen rife install (an 830 MB zip, 45 MB kept, sha256-checked, into the user data directory); SPRITE_GEN_RIFE or PATH override it (nihui's 20221029 on PATH has no rife-v4.25: install, or set SPRITE_GEN_RIFE); SPRITE_GEN_RIFE_MODEL_NAME=rife-v4.6 runs the old model with -x -z, its frames 3.14.0's; Linux without a GPU also needs libvulkan1 mesa-vulkan-drivers. Without it, walk and run loops are cut as filmed with a warning. SPRITE_GEN_RIFE_BACKEND=torch runs the same model in PyTorch instead, for a GPU with no Vulkan (pip install \"sprite-gen[torch]\", then sprite-gen rife install --backend torch; SPRITE_GEN_RIFE_DEVICE=cuda or cpu; SPRITE_GEN_RIFE_EXECUTOR=module:attr sends its frames to a GPU elsewhere, rife_torch.serve there)"
required_scripts:
- scripts/prepare_sprite_run.py
- scripts/generate_sprite_image.py
- scripts/gen_set.py
- scripts/generate_sprite_video.py
- scripts/video_canvas.py
- scripts/video_frames.py
- scripts/video_loop.py
- scripts/video_set.py
- scripts/extract_sprite_row_frames.py
- scripts/interpolate_frames.py
- scripts/compose_sprite_atlas.py
- scripts/preview_animation.py
- scripts/compose_selected_cycle.py
- scripts/compose_sprite_gif.py
- scripts/inspect_sprite_run.py
- scripts/score_sprite_run.py
- scripts/run_correction_loop.py
- scripts/curation.py
- scripts/serve_curation.py
- scripts/slice_sheet_cells.py
- scripts/unpack_atlas_run.py
- scripts/export_curated_pngs.py
- scripts/recolor.py
modes:
default: component-row
Sprite Gen
Generation entry points: make sprites, make an image, or animate a still into a video. Existing generation, extraction and export tools do the work; the user chooses the result and provider. For repeat a background, project a shadow, inspect motion or compose a scene, use the independent routes below directly with existing assets.
Start every generation request here
For a standalone video clip, read video and use sprite-gen video.
This route works from any agent engine and delivers a verified MP4 plus report.
For sprites or ordinary images, use the guides below.
Read user-workflow, then run the appropriate read-only guide:
$SPRITE_GEN_ROOT/.venv/bin/sprite-gen workflow --kind sprite
$SPRITE_GEN_ROOT/.venv/bin/sprite-gen workflow --kind image
When codex cannot run β exit 75
A call that names no provider (gen, logo, gen-set, video-set's mid-step redraw) runs on codex. When codex cannot run here β not signed in, or the codex usage of the account used up β and the user's choice for that is to ask (the default), the command generates nothing, prints one stderr line starting sprite-gen ask codex-unavailable: followed by JSON, and ends with exit 75. That is a question for the user, not a failure: never answer it yourself, never retry without the answer, never switch provider on your own.
Ask it in these words, with the reason from the line's cause (login: "λ‘κ·ΈμΈμ΄ μμ΄μ", usage-limit: "μ¬μ©λμ λ€ μΌμ΄μ"):
μ§νΌν°(codex)λ₯Ό μ§κΈ μΈ μ μμ΄μ β {μ΄μ }. μ΄λ»κ² ν κΉμ?
- OpenAI API λ‘ λ§λ€κΈ° (νΈμΆλΉ κ³ΌκΈ)
- κ·Έλ‘μΌλ‘ λ§λ€κΈ°
- λ©μΆκΈ°
Side-view facing
Keep the side still, canvas placement and motion prompt facing the same direction.
video-set observes each side input once before canvas placement and uses the requested
--facing for both the canvas and clip prompt. Observation is record-only by default;
it never changes the requested direction. Image correction requires explicit opt-in.
Direction is requested through the generation and motion prompts, which cannot guarantee model compliance.
The detector can be wrong even at high confidence: review the still before choosing mirror or regen.
Generation reports record direction, model, requested direction, model-reported confidence and correction
under extra.facing; video reports and batch items use facing. final_direction is an observation
or a value derived from it, not independent verification; final_direction_source identifies which.
An uncertain or failed inspection records unknown and its reason and continues without correction;
front-facing observations also remain unchanged. Mirroring does not preserve left/right accessory handedness.
Execution routes
| Task | Entry | Contract |
|---|---|---|
| GPT image sprites | prepare, gen-set --provider codex, extract, compose and QA | atlas-workflow |
| Standalone video / animate a still, pin a last frame, reference images | video (--image, --last-frame, --reference) | video |
| Continue or edit an existing clip | video-extend, video-edit | video |
| A clip run left unfinished (its line or report names a request_id): ask for it again, never submit it again | video-resume --request-id <id> | video |
| Grok video sprites | video-set | video-pipeline |
| A soft part of a walk loop or cycle frames sways with the body (the Sway layer): an ellipse after video-cycle-align, --read-on <sha256> for a cut, --stretch-floor D for least area, --frames for full frames, --breathe for the breath drive, a flat share to move a region whole, --gain-across for across gain, and --reference for a way in or out of a loop | video-sway (old name video-follow) | video-pipeline |
| Where an ellipse is carried in every other cell, and what the move changes there (an arm crossing a chest moves with it; the stretch, the bend and the seam): a record and boards of every cell, nothing moved; a seam under a third moving region is not counted | video-sway-inspect (old name video-follow-inspect) | video-pipeline |
| A set's directions on one sheet, standing on one ground line (a 3Γ3 board, an engine import) | video-set-sheet | video-pipeline |
| A walk or run that stops, from the clip's own start played backwards | video-stop | video-pipeline |
| Pieces of keyed clips on one canvas played as one move, at the time the caller gives | video-chain | video-pipeline |
| Build a talking lower-face pack anchored to every frame of body motions from a reference and keyed clips. | video-face | face-parts |
| Bake a voice and the pack's face layer onto body frames, optionally after a clip's own mouth and sound. | face-bake | face-parts |
| Compare the currently displayed loop with a final candidate, including after follow-through | video-loop-compare | loop-comparison |
| Restore post-processing damage in the current cut from its exact source times, preserving normal cells and playback | video-source-manifest β video-loop-repair β video-loop-compare | source restoration |
| Video sprites from a clip your agent makes with a connected video MCP (ZCRE, μ§ν¬) | video-canvas, video-prompt --no-last-frame, the agent's own MCP tools (quote, user approval, generate, save the mp4), then video-frames and video-loop, and for a walk or run cut in two or more directions video-cycle-align --view β¦ over their loop directories. sprite-gen never calls the MCP. | video-pipeline |
| Typography logo, wordmark or title lettering (λ‘κ³ , νμ΄ν¬κ·ΈλνΌ, νμ΄ν κΈμ): the title lettered into a title screen or poster first, then only its lettering redrawn on a key and cut out with its glow; the text is read back and a misspelt logo refused | logo --text β¦ --style β¦ (--mood to start from a picture you have, --lettering to cut again for nothing) | logo |
| Ordinary image or edit | gen --provider codex or gen --provider grok (the subscription login first; without one grok uses XAI_API_KEY, and a codex signed in with an API key bills it β both per call, said on stderr) | gen |
| Pixel art the model draws directly as a grid, 8β48 px, on your Claude subscription (claude signed in), or without one on ANTHROPIC_API_KEY, billed per call | pixel-draw | pixel-draw |
| Image generation with no login available (server, container, SaaS) | gen --provider openai β server/SaaS route on OPENAI_API_KEY, billed per call, never a default; it runs only when named, or when the user chose it for a codex that cannot run | gen |
| Base and direction anchors | anchor | directional-anchor-workflow |
| Curation view or existing image candidates | curation, unpack-atlas --pngs-dir | curation |
| Uniform background removal or imported sheets | cutout, slice-sheet | sheet-slicing |
| Palette swap | sprite-gen recolor-palette, sprite-gen recolor | recolor |
| Idle breathing as a post-processing layer (the Breathe layer): pixel (default, pixel art) or smooth (large illustrations, video frames: head fixed, chest breathes, shoulders follow; facing values for a turned body); smooth can choose a beat that misses the hands with --avoid-region, and a way in or out of a loop carries on its breath with --loop-cells, --start-cell and --reference; pixel can breathe round from the chest with the arms moving sideways (--chest-round, --arms-x), cells held still (--hold-mask), what the arms hold moving whole with them (--props-mask), what the arms hold behind the body (a shield hung at the back) moves the same way with the body staying in front (--props-behind-mask), and pieces painted one colour move together (--props-groups colour, so a sword's reflection follows the sword) | curation sidecar, baked by compose; or sprite-gen breathe <frames> <out> on a folder of loop frames | [breathing](docs/breathing.md
Truncated for display β read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
ruflo
81.9kπ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
