Agent Skills
› fanfan-de/anybox
› sprite-pipeline
sprite-pipeline
GitHub用于生成和标准化2D精灵动画。以单帧种子为基础，批量生成完整动画条带，并通过脚本统一缩放、锚点及透明度，确保角色一致性，最终输出游戏可用资产。
Trigger Scenarios
用户请求从已批准的源帧生成完整动画条带
需要一致的对齐和缩放规范化
为浏览器游戏动画创建预览资源
Install
npx skills add fanfan-de/anybox --skill sprite-pipeline -g -y
SKILL.md
Frontmatter
{
"name": "sprite-pipeline",
"description": "Generate and normalize 2D sprite animations. Use when the user asks for full-strip generation from approved source frames, consistent anchor and scale normalization, or preview assets for browser-game animation."
}
Sprite Pipeline
Overview
Use this skill for 2D sprite generation and normalization. This workflow is intentionally anchored around one approved frame and a whole-strip generation pass because frame-by-frame generation drifts too easily.
This skill is 2D-specific. If the request is for 3D characters, meshes, or materials, route back through ../game-studio/SKILL.md.
Core Workflow
- Start from an approved in-game seed frame.
- The seed frame should already reflect the right silhouette, palette, costume, and proportions.
- Build a larger transparent reference canvas around that frame.
- Use
../../scripts/build_sprite_edit_canvas.py.
- Use
- Ask for the full animation strip in one edit request.
- Do not generate each frame independently unless the user explicitly accepts lower consistency.
- Normalize the result into fixed-size game frames.
- Use
../../scripts/normalize_sprite_strip.py. - Use one shared scale across the whole strip.
- Align frames with one shared anchor, typically bottom-center.
- Use
- Optionally lock frame 01 back to the shipped seed frame.
- Do this when the animation should begin from the exact idle or base pose already in game.
- Render a preview sheet and inspect the animation in-engine before approving it.
- Use
../../scripts/render_sprite_preview_sheet.py.
- Use
Prompting Rules
Always preserve these invariants in the prompt:
- same character
- same facing direction
- same palette family
- same silhouette family
- same readable face or key features
- same outfit proportions
- transparent background
- exact frame count and slot layout
Always ask for:
- one strip at once
- a transparent canvas
- no scenery, labels, or poster composition
- crisp pixel-art clusters for pixel work
- production asset tone, not concept art
Using Image Generation
For live asset generation or edits, use the installed imagegen skill in this workspace. This skill defines the game-specific process; imagegen handles the API-backed generation or edit execution.
Script Recipes
Create a reference canvas:
python3 scripts/build_sprite_edit_canvas.py \
--seed output/sprites/idle-01.png \
--out output/sprites/hurt-edit-canvas.png \
--frames 4 \
--slot-size 256 \
--canvas-size 1024
Normalize a raw strip:
python3 scripts/normalize_sprite_strip.py \
--input output/sprites/hurt-raw.png \
--out-dir output/sprites/hurt \
--frames 4 \
--frame-size 64 \
--anchor output/sprites/idle-01.png \
--lock-frame1
Render a preview sheet:
python3 scripts/render_sprite_preview_sheet.py \
--frames-dir output/sprites/hurt \
--out output/sprites/hurt-preview.png \
--columns 4
Quality Gates
- proportions stay stable across frames
- frame-to-frame size does not drift
- action reads clearly at game scale
- transparency is preserved
- frame 01 matches the shipped sprite when lockback is enabled
- preview looks correct before any in-engine asset index update
References
- Detailed workflow:
../../references/sprite-pipeline.md - Shared frontend context:
../game-ui-frontend/SKILL.md
Version History
- 08dc189 Current 2026-07-05 18:59
