Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
Merge branch 'main' into plan/asset-tools-and-scenes
Soohong Kimab242b398b3d
diff --cc CHANGELOG.mdindex 085d93e,7fdee09..42e73e3--- a/CHANGELOG.md+++ b/CHANGELOG.md@@@ -2,16 -2,10 +2,16 @@@All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.-## Unreleased (v2.2.0)+## v2.2.0 - Independent asset tools and optional scenes++- Added standalone `background-tile`, `shadow` and `inspect-motion` commands. They accept existing artwork and report tile joins, anchor-preserving shadow projections, repeated poses and explicit foot-contact measurements without changing source animation.+- Added optional `scene-render` and `scene-inspect` with asset references, planes, placement, playback rate, camera, lighting, PNG/MP4/GIF output and layer/placement export. Scene applies only verified stride for the matching asset and an explicitly chosen direction.+- Added one read-only adapter for PNGs, external frame descriptors, existing loop strips and runtime atlases, preserving native timing and anchors. Source fingerprints bind measurements to loaded content; output publication uses shared locking and atomic writes.+- Split the command catalog into ordered sprite pipelines, independent tool groups and optional workflows. Added background recipes and asset/scene contracts to the skill and documentation, plus a 20 fps, 256-colour village GIF below the existing README showcase.+- Raised the Pillow minimum to 12.3.0 for its upstream security fixes; existing environments must update separately to satisfy the new requirement.- Grok images now call xAI Imagine directly for generation and one-to-five-reference editing, without spawning Grok Build. The default image model is `grok-imagine-image-2.0`; `--model` now selects the image API model. Responses are decoded and published as verified PNGs with existing chroma cleanup preserved.- - Images and videos share one credential reader: `XAI_API_KEY` first, otherwise the user's Grok login (`GROK_HOME` supported). Image reports expose the auth source and API endpoint. The workflow guide checks the same source and explicitly confirms API-credit billing for either media type. Expired login and request failures stop without agent fallback or automatic image request retries.+ - Images and videos share one credential reader: the user's Grok subscription login first (`GROK_HOME` supported), even with `XAI_API_KEY` configured. Only an absent login file permits API-credit use; invalid, expired or rejected logins never fall back to it. Image reports expose the auth source and API endpoint. The workflow guide checks the same source and explicitly confirms API-credit billing for either media type. Expired login and request failures stop without agent fallback or automatic image request retries.- Standalone image-to-video requests are routed by the sprite-gen skill itself; no separate video skill is needed.- The flat-border colour that decides the painted key no longer has to balance its keyed channels. Grok paints `#FF00FF` as (216, 46, 147) / (225, 52, 155) / (236, 59, 161) — blue/red ≈ 0.68, under the 0.8 balance the interior family rule (`is_key_family`) demands — so `detect_background_key_rgb` fell back to the declared key and, at ~120 from pure magenta, the whole background survived (2026-09-11 rev3 objects). A border is already background evidence: the new border rule `is_border_key_candidate` (keyed channels lit, unkeyed channels dark and under 35 % of the brightest keyed one — a superset of `is_key_family`) is the one function `detect_background_key_rgb`, `cutout --key auto`, `video-canvas --key` and the `video-frames` residual/subject split classify the border with. The interior rule is unchanged; hot pink (250, 77, 150) and purple (213, 112, 246) inside the subject still survive.