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

Soohong Kim85b394cfd312
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ae15c71..e3bde94 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 frame RIFE made whose legs melted is caught by the outline it lost, and the set alignment takes the nearer source frame there
+## v2.28.0 - A frame RIFE made whose legs melted is caught by the outline it lost, and the set alignment takes the nearer source frame there
- **Output change: which frames `video-cycle-align` keeps from RIFE.** `--between` gains `auto`, now the default (`video-set --align-between` too): every frame between two source frames is still made by RIFE and measured, and one that smeared or lost its outline takes the nearer source frame instead, named in the warnings. A set whose made frames all keep their outline comes out byte for byte as 2.27.0's; where one melted, that frame is now the nearer filmed frame, the loop's `cycle_align` gains `nearest_at` beside `made_at`, and `made_by_rife` counts only the frames kept. `--between rife` gives 2.27.0's frames, with the new warnings; `nearest` is unchanged.
- **Fix: a frame RIFE melted passed without a word.** Where two drawings are too far apart for the flow — legs crossing a long way, as a clip drawn on twos gives between its drawings — RIFE draws the legs as one shape of fill with no outline between or around them. 2.25.0's smear check warns only on dark pixels added, and a melted frame has fewer: it lost its outline. `rife.smear` now also measures `outline_loss`: of the frame's coverage edge (alpha from 0.1, so a pale ghost limb's edge counts), the share with no dark pixel within 2 px, beyond the less outlined neighbour's. Over 5 % (`align.OUTLINE_WARN`) the frame has the fault `outline`; over 0.1 % dark, as before, `smear` (`align.faults`). The dark count's other side does not do this: a clean frame half way between two drawings has fewer dark pixels than the darker one wherever they differ, and on two outlined legs RIFE's clean frames of a short step read `dark_excess` −1.3 %, lower than its melted frame of a long crossing (−1.1 %); `outline_loss` reads under 3 % and 32 % (`tests/video/test_rife.py`). `partial_excess` is still reported and not judged: a melted frame and a clean one read alike on it.
diff --git a/SKILL.md b/SKILL.md
index fc9a8f7..9abd04c 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 2.27.0
+version: 2.28.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 1c855af..c1fdfcc 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.27.0"
+version = "2.28.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"