godot-sprite-animation
Use when importing, aligning, slicing, padding, or wiring 2D sprite sheets and Godot AnimatedSprite2D/SpriteFrames resources for this project. Trigger for animation stability, frame sizing, AtlasTexture margin, sprite sheet grids, hit-frame timing, feet alignment, or fixing visual jitter in Godot pi
Install
mkdir -p .claude/skills/godot-sprite-animation && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16545" && unzip -o skill.zip -d .claude/skills/godot-sprite-animation && rm skill.zipInstalls to .claude/skills/godot-sprite-animation
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use when importing, aligning, slicing, padding, or wiring 2D sprite sheets and Godot AnimatedSprite2D/SpriteFrames resources for this project. Trigger for animation stability, frame sizing, AtlasTexture margin, sprite sheet grids, hit-frame timing, feet alignment, or fixing visual jitter in Godot pixel-art character animations.About this skill
Godot Sprite Animation Workflow
职责边界
这个 skill 只管 Godot 里的 sprite animation 接入和稳定性：
- slicing
- padding
SpriteFramesAnimatedSprite2DAtlasTexture.regionAtlasTexture.margin- feet baseline
- hit-frame timing
- visual jitter
它不负责定义项目美术风格。风格、prompt、canvas 目标、透明背景、像素规则以 prototype-alpha-pixel-art-style 和 docs/ART_PIPELINE.md 为准。
Preferred Asset Shape
接入 Godot 时，优先使用 regular sprite sheet：
- consistent frame size
- transparent PNG
- regular grid layout
- stable character position
- feet aligned across frames
- same camera angle and scale
Demo 阶段 animation stability 比高细节更重要。
Import Strategy
For regular sprite sheets:
- 使用
SpriteFrames给AnimatedSprite2D。 - 使用
AtlasTexture.region从 sheet 引用每帧。 - 当源帧小于项目目标帧时，使用
AtlasTexture.margin添加虚拟透明 padding。 - 不要手切一堆单独 PNG，除非 alignment 或工具链确实需要。
如果动画必须匹配现有 knight frames，先比较当前项目使用的 96x84 frame convention 和 feet baseline，再接入 gameplay。
Alignment Rules
当新动画看起来偏移：
- 测量 source frame size 和 existing target frame size。
- 测量 non-transparent pixel bounds。
- 先对齐 feet/bottom baseline。
- 再对齐 body center。
- 只有角色身体本身尺寸真的不同，才考虑 scale。
不要通过改 AnimatedSprite2D.scale 修 padding 问题。这样通常会让 animation swap、hitbox 和 gameplay range 变得不一致。
Timing Rules
Combat animations:
- 视觉上找 active hit frames。
- damage / hitbox / projectile spawn 放在那些帧，而不是 animation start。
- key pose 太快时，优先增加该帧
duration或重复帧。 - action lock time 不能短于可见动作，否则 movement/idle 可能打断攻击。
Runtime Wiring
给 runtime-built SpriteFrames 加动画时：
- Load
.tresSpriteFramesresource。 - Copy frames into runtime
SpriteFramesunder gameplay animation name。 - Preserve source animation speed、loop setting、texture、per-frame duration。
- Gameplay animation name 保持短且稳定，例如
shield_charge。
Validation
完成前检查：
- frame count
- final displayed frame size
- feet baseline 与附近动画一致
- hit timing 匹配 visible impact frames
- action lock time 不短于 animation