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

Soohong Kimf03e1b68c88a
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 48812e4..0d5e443 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 loop whose foot the set alignment cannot name is told it, one loop at a time
+## v2.31.0 - A loop whose foot the set alignment cannot name is told it, one loop at a time
- **New `video-cycle-align --foot <loop>=left|right`** (repeatable; the loop named as for `--cycles`: its `--loop-dir`, its strip's name, its directory's name or a `video-set` item's name) and **`video-set --align-foot <item>=left|right`**: which own foot lands on a loop's first strike, as seen by whoever looked at it — a person, the agent, or a vision call. Where a loop's view cannot tell its feet apart (`start_foot: null`), `--start-foot` was set-wide and there was no way to say "this loop's larger strike is its left foot". Now that loop alone starts as the set's start foot lands — on its first strike, or half a cycle on — and every other loop comes out byte for byte as without it. The answer is about the loop as filmed (its strikes are read from `cycle.source/`), so it holds for a later alignment at the same length; like `--cycles` it is not remembered. A foot given for a loop the view did name is taken too, and where it disagrees the row carries `foot_disagrees` and a warning. A `--foot` that names no loop or two, or is not `left`/`right`, is refused before anything is rewritten; `video-set` refuses an `--align-foot` item that is not a walk or run filmed in two or more directions before filming, and names one given for an item that failed or whose state was not aligned in that state's `feet_unused` and a warning. The way feet are named from the pixels is unchanged.
- **New in the alignment report: `unnamed_feet`**, per loop whose foot nobody named: `dir`, `name`, `view`, `foot_why`, `candidates` (its two strikes: `strike` 0 and 1, `frame` in the rebuilt `cycle/` and the `path` to that frame — the frame to show whoever looks; the first is the frame the loop starts on) and `settle` (the two `--foot` arguments). The report also gains `feet_given`; every loop row and its `strip.json` `cycle_align` gain `start_foot_source` (`"engine"` where the view's cue named the foot, `"given"` from `--foot`, `null` where nobody did) and `strikes` (the two strikes as frames of the rebuilt `cycle/`), and a told row `foot_given` and, where the engine had not named it, `foot_unnamed_why` instead of `foot_why`. `video-set` carries `unnamed_feet` and `feet_given` per state and `start_foot_source` per item; a stopped set's `command` carries the `--foot` given. The warning for an unnamed loop now names the frame to look at and the `--foot` that settles it. Without `--foot`, the cycle, strip, GIF and WebP are unchanged. [docs/loop-repair.md](docs/loop-repair.md#4-one-cycle-for-a-direction-set--video-cycle-align-video-set---align-cycles-auto), [docs/video-pipeline.md](docs/video-pipeline.md).
diff --git a/SKILL.md b/SKILL.md
index 0ba962e..32f3bf5 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 2.30.0
+version: 2.31.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 092c3d9..2613107 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.30.0"
+version = "2.31.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"