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.30.0

Soohong Kim2e7ed114f507
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 33876a1..dd43f90 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 held loop is judged on the cycle cut out of its clip, not on the whole clip
+## v2.30.0 - A held loop is judged on the cycle cut out of its clip, not on the whole clip
- **Output change: which loops `video-cycle-align` names for a retake** (`held-drawings`). The hold was read over the whole clip and given to the cut cycle, so a clip held for part of its length and drawn every frame for the rest was judged by the clip: a cycle cut from its every-frame part and stretched could be named (the clip reads as held), and one cut from its held part was passed (the clip reads as drawn every frame). `video-loop` now also reads the hold over the cut, on the clip's own steps as keyed from the cut's first frame into the frame after its last (`cycle_drawings` in the loop report and in `strip.json`: `start`, `length`, `steps`, `hold`, `drawings_per_second`, `contrast`), and the alignment uses it (`drawings.source: "span"`, with the clip's reading under `drawings.clip`). A cut of fewer than 12 steps (`held.SPAN_MIN_STEPS`, one window of the clip's reading) is not read on its own: the clip's reading stands (`source: "clip"`), and the row's `span_why` says so, as it does for a loop cut by 2.29.0. A clip held or drawn every frame throughout reads the same over its cut as over the whole: the cut, the strip, the GIF and the WebP are unchanged, and the loop report and `strip.json` gain `cycle_drawings`. [docs/loop-repair.md](docs/loop-repair.md#4-one-cycle-for-a-direction-set--video-cycle-align-video-set---align-cycles-auto).
diff --git a/SKILL.md b/SKILL.md
index 1f6287b..2da726a 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 2.29.0
+version: 2.30.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 146ee02..092c3d9 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.29.0"
+version = "2.30.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"