Skip to content

Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.

docs: show both the one-handed and two-handed samurai cuts

Soohong Kim5fd6320e03fc
diff --git a/CHANGELOG.md b/CHANGELOG.md
index aa4bec2..d64358d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,7 +16,7 @@ All notable public changes to `sprite-gen` are recorded here. Versions track the
- Attack canvases reserve overhead room as well as forward room for raised weapon swings. Wide padding now honors headroom while preserving 16:9 and the still pixels; idle, walk, run and jump defaults are unchanged.
- The attack motion prompt now tells the video model to strike with the weapon the character already holds and to keep its gear and outfit as drawn, so an armed sprite does not fall back to punching or grow new equipment mid-clip.
-- Attack showcase: `docs/assets/attack-slime.gif`, `attack-fox-hood.gif`, `attack-paladin.gif` and `attack-claudecy-samurai.gif` were produced by this release's pipeline (still, canvas, Grok Imagine clip, frames gate, loop selection) with no manual cut points. On a ten-character side-view sample every attack closed its loop; two clips needed the built-in single regeneration because the model framed the raised weapon above the top edge.
+- Attack showcase: `docs/assets/attack-slime.gif`, `attack-fox-hood.gif`, `attack-paladin.gif`, `attack-claudecy-samurai.gif` (two-handed cut) and `attack-claudecy-samurai-onehand.gif` were produced by this release's pipeline (still, canvas, Grok Imagine clip, frames gate, loop selection) with no manual cut points. On a ten-character side-view sample every attack closed its loop; two clips needed the built-in single regeneration because the model framed the raised weapon above the top edge.
## v2.5.2 - Cleaner video spill correction
diff --git a/README.md b/README.md
index 25d50e6..4f6e9b5 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,8 @@ Ask an image model for a "sprite sheet" and you know what you get: a character w
For side sprites, `video-set` uses `--facing right|left` consistently across canvas placement and clip prompts. Its direction detector is **record-only by default** (`--facing-fix none`) and can be wrong even at high confidence. Use `gen --ref image.png --facing right` to request orientation in the generation prompt; `gen` otherwise preserves orientation. Prompts request direction but cannot guarantee the result. Correction is opt-in: `--facing-fix mirror`, or `gen --facing-fix regen`; review the still before using either. See [facing options](SKILL.md#side-view-facing).
<p align="center">
- <img src="docs/assets/attack-claudecy-samurai.gif" height="160" alt="Samurai Claudecy katana cut loop">
+ <img src="docs/assets/attack-claudecy-samurai.gif" height="160" alt="Samurai Claudecy two-handed katana cut loop">
+ <img src="docs/assets/attack-claudecy-samurai-onehand.gif" height="160" alt="Samurai Claudecy one-handed katana cut loop">
<img src="docs/assets/attack-slime.gif" height="160" alt="Slime attack loop">
<img src="docs/assets/attack-fox-hood.gif" height="160" alt="Hooded fox attack loop">
<img src="docs/assets/attack-paladin.gif" height="160" alt="Paladin attack loop">
diff --git a/docs/assets/attack-claudecy-samurai-onehand.gif b/docs/assets/attack-claudecy-samurai-onehand.gif
new file mode 100644
index 0000000..40eb695
Binary files /dev/null and b/docs/assets/attack-claudecy-samurai-onehand.gif differ