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: 3.15.0, the Unreleased CHANGELOG section named for the release, pyproject and SKILL.md at 3.15.0

Soohong Kimfc4e856eb360
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4920d20..11f64e3 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
+## v3.15.0 - RIFE is `rife-v4.25` from TNTwise's 20250112 release by default, padded to 128 with no augmentation, the old `rife-v4.6` kept by name (`SPRITE_GEN_RIFE_MODEL_NAME`), and `sprite-gen rife install` run again
**Upgrading from 3.14.0: RIFE is rife-v4.25 by default, so every frame RIFE makes changes, `sprite-gen rife install` must run again, and the old model is one variable away.** The engine runs TNTwise's rife-ncnn-vulkan 20250112 and its `rife-v4.25` with no augmentation, each image padded to 128; 3.14.0 ran nihui's 20221029 and `rife-v4.6` with `-x -z`. A cut with no held cell and no repair runs no RIFE and keeps its bytes (`tests/video/test_held_fill.py::test_a_cut_with_no_held_cell_runs_no_rife_and_is_the_same_bytes_whichever_model`); a cut whose held cells are filled, a repaired walk and a set's alignment get rife-v4.25's frames, and can take more or fewer poses. Run `sprite-gen rife install` once (an 830 MB zip, 45 MB kept, into a new directory beside the old install). A 20221029 binary on `PATH` holds no `rife-v4.25/` and now reads as RIFE not installed: install, or set `SPRITE_GEN_RIFE`. `SPRITE_GEN_RIFE_MODEL_NAME=rife-v4.6` runs the old model as it ran, its frames 3.14.0's to the byte. A `--between-cache` keys frames by model, so frames kept by 3.14.0 are not taken. With the torch backend, `sprite-gen rife install --backend torch` again; an executor and its host must name the same model.
diff --git a/SKILL.md b/SKILL.md
index f543f7a..e7123bc 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 3.14.0
+version: 3.15.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, typography logos (로고, 타이포그래피, 타이틀 글자, 타이틀 로고, wordmark, logo, title lettering: a title screen drawn with the title in it, its lettering lifted out transparent), 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, engine exports, repeating backgrounds, projected shadows, talking face layers over body motions (말하는 얼굴, 입 맞추기, 얼굴 층, lip sync, face pack), 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 8f99026..a6d6f07 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 = "3.14.0"
+version = "3.15.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"