Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
release: v2.27.0
Soohong Kimcf5257814aba
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 60ae242..5ad53ed 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 set is not aligned with a loop that may hold two cycles until someone counts them, and only that count takes one cycle out of it+## v2.27.0 - A set is not aligned with a loop that may hold two cycles until someone counts them, and only that count takes one cycle out of it- **Output change: which sets `video-cycle-align` rewrites.** `video-loop`'s output is 2.25.0's and 2.26.0's: every cut keeps its period, length and start, whatever its legs or shading (the report gains `cycle.fundamental`, and `strip.json` gains `state`). `video-cycle-align` now **stops a set** — nothing rewritten, exit status 1 — where one of its loops may hold two or three cycles (a half or a third of it repeats and is no shorter than the gait floor), and 2.26.0 aligned it; the report is written with `applied: false`, `refused: "cycle-suspects"` and the typed `suspects`. A set with no suspect is aligned as before, every loop resampled from all of its filmed frames. `video-set --align-cycles auto` skips such a state with a warning (`applied: false`, `reason: "cycle-suspects"`, `suspects`) where it aligned it, and the RIFE skip now carries `reason: "rife-not-installed"`. The number of cycles in a loop changes only through the new `--cycles`.- **Fix: a walk filmed through two strides walked twice as fast as its set, without a word.** A clip drawn on twos whose stride is an odd number of frames repeats better two strides on than one, so `video-loop` cut two strides as one loop, and `video-cycle-align`, which gives every loop one length on the assumption that each holds one cycle, squeezed both into it. The engine does not cut such a loop shorter on the pixels' word: half a stride on, the legs are back in place with near and far swapped, and where they are drawn alike that one step and a true stride half a drawing late are the same picture, so every rule that took the half took some one-stride walk or run to its half step. Instead the shorter repeat is screened (`sprite_gen/video/period.py`: `screen` measures the half and the third — `periodicity`, `pose` off the motion's path, and for the record the legs' `steps` and `follow` — and one rule, `period.verdict`, decides: a half or a third that repeats is a `suspect`, whatever its pose; nothing says "a cycle" and nothing says "not one"). `video-loop` records it (`cycle.fundamental`: `checked`, `suspects`, `legs`), and so does the local search of `--anchor motion-auto`. `video-cycle-align` screens each loop as a ring (`align.cycle_screen`) and stops a set on a suspect, naming the loop, where it returns (frames and seconds), the evidence and the command that settles it (`command`, the same alignment with `--cycles <loop>=<1|2>` to fill in); `--multi-cycle warn` aligns it as it is with a warning per suspect. The pose is not a reason to refuse: a rule that refused "another pose" missed most two-stride loops whose second stride was redrawn a pixel aside or a few per cent lighter, which in pixels is off the motion's path just as a swapped step is. The cost is the other way: a run's half step repeats too, so a run set stops nearly every time until its loops are counted ([docs/video-pipeline.md](docs/video-pipeline.md) section 4, "The fundamental period").diff --git a/SKILL.md b/SKILL.mdindex 09f480f..ebd2ed7 100644--- a/SKILL.md+++ b/SKILL.md@@ -1,6 +1,6 @@---name: sprite-gen-version: 2.26.0+version: 2.27.0description: "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.0depends_on:diff --git a/pyproject.toml b/pyproject.tomlindex fed238f..1c855af 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.26.0"+version = "2.27.0"description = "Component-row pipeline for clean 2D game sprites and animation atlases"readme = "README.md"license = "Apache-2.0"