Skip to content

Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.

release: v2.29.0

Soohong Kim41b12cb318a5
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 73b19f8..dcee34f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.
-## Unreleased - A clip that shows each drawing for two or three frames is read as such, and the set alignment names a held loop it could not fill as a take to film again
+## v2.29.0 - A clip that shows each drawing for two or three frames is read as such, and the set alignment names a held loop it could not fill as a take to film again
- **New: `video-cycle-align` names a loop to film again** (`retake`, reason `held-drawings`). A loop whose clip holds each drawing for two or three frames ("on twos", "on threes"), that the set's length leaves at under 13 drawings a second (`align.RETAKE_DRAWINGS_MIN`; a clip on twos shows 12), with one or more frames between its drawings not made (`align.RETAKE_UNMADE_MIN`: taken from the nearer source frame under `--between auto` or `nearest`, made with a fault and kept under `rife`), is listed in the report's `retake` (`dir`, `name`, `hold`, `source`, `drawings`, `drawings_per_second_filmed`, `drawings_per_second`, `frames_per_drawing`, `unmade`, `limits`) and in a warning line ("film this direction again (held-drawings) — …"). Where the legs swap places between two drawings no interpolator draws them, so each frame `auto` took from the nearer source frame holds a drawing a frame longer and the loop halts there; only a new take drawn every frame fixes it. The set is still aligned and written, exit 0: the reason is for the caller to act on, never silent. Each loop row and its `strip.json` `cycle_align` gain `drawings` (the hold, read from the clip's record) and `retake` (the record, or `null`); `video-set` carries `retake` per state and per item. A held loop at its own length (nothing made), a held loop whose made frames all kept their outline, one squeezed to 13 drawings a second or more, and a loop drawn every frame with a replaced frame are not named.
- **New: `video-loop` records the clip's drawings** (`drawings` in the loop report and in `strip.json`, `hold`/`drawings_per_second` in the printed summary): whether the clip shows each drawing for one, two or three frames, how many drawings a second, the held steps, and `contrast` per hold as the evidence (`sprite_gen/video/held.py`), read over the whole clip as keyed, before the cut. The alignment reads the hold from `strip.json`: a cut cycle is short, and `--anchor motion-auto` shifts each cut frame so a pair's repeat may no longer read as one; a loop cut before this record is measured on its own cycle. The cut, the strip, the GIF and the WebP are unchanged.
diff --git a/SKILL.md b/SKILL.md
index d644bd3..0137f0a 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 2.28.0
+version: 2.29.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, 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, rig layers, engine exports, repeating backgrounds, projected shadows, motion/contact inspection and optional scene composition from existing assets."
license: Apache-2.0
depends_on:
diff --git a/pyproject.toml b/pyproject.toml
index c1fdfcc..146ee02 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
name = "sprite-gen"
# Release discipline: keep this package metadata version synchronized with
# SKILL.md's `version:` field in the same release commit.
-version = "2.28.0"
+version = "2.29.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"