[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E6FDMPB5TABVFQQX6DZGFR":3,"skill-same:01M7E6FDMPB5TABVFQQX6DZGFR":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7E6FDMPB5TABVFQQX6DZGFR","animation",null,"Use when a Godot character or object needs animation states, blending, attacks that must not be cut short, root motion, or when an animation feels stiff, floaty or unreadable.","nick-vas\u002Fhyperdot","nick-vas","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7181961?v=4","01M7E6F6F0BQ49V0JZHX9BXCBD","Nikolaos Vasilikiotis","01M7E6F6FZW8SW1AJ1S7ARFE89",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fanimation\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: animation\ndescription: Use when a Godot character or object needs animation states, blending, attacks that must not be cut short, root motion, or when an animation feels stiff, floaty or unreadable.\n---\n\n# Animation in Godot 4\n\n`AnimationPlayer` holds the clips; `AnimationTree` decides which play and how they blend (both are `AnimationMixer`s). Notes,\ntests and sources: `${CLAUDE_PLUGIN_ROOT}\u002Fdocs\u002Fart.md`.\n\n## 1. A state machine with rules\n\nA tree whose root is an `AnimationNodeStateMachine`: Idle, Walk, Run, Jump, Fall, Attack. Each\n`AnimationNodeStateMachineTransition` has:\n\n| Property | Use |\n|---|---|\n| `SwitchMode` | `Immediate`; `Sync` (switch now, keep the play position: walk to run); `AtEnd` (wait for the clip to end) |\n| `AdvanceMode` | `Disabled` (never used); `Enabled` (only by `Travel`); `Auto` (taken by itself when its condition holds) |\n| `AdvanceCondition` | a bool parameter, `parameters\u002Fconditions\u002F\u003Cname>`; true only, so \"not moving\" is its own condition |\n| `AdvanceExpression` | an expression on `AdvanceExpressionBaseNode` (point it at the character), e.g. `is_on_floor()` |\n| `XfadeTime`, `XfadeCurve` | the blend between the two; 0.1 to 0.2 s for most moves |\n| `Priority` | lower wins when several auto transitions are open |\n\n```csharp\nvar playback = _tree.Get(\"parameters\u002Fplayback\").As\u003CAnimationNodeStateMachinePlayback>();\n_tree.Set(\"parameters\u002Fconditions\u002Fmoving\", Velocity.Length() > 0.1f);\nif (attackPressed) playback.Travel(\"Attack\");\n```\n\nInterruption rules, tested in 4.7.2:\n\n- `Travel(x)` follows a path over transitions that are not `Disabled`, ignoring conditions; each step keeps its own switch\n  mode. So a travel requested mid-attack waits when every edge out of Attack is `AtEnd`.\n- With no path, `Travel` jumps straight there, cutting an attack short. Wire every state you travel to.\n- `Start(x)` always cuts in at once: for death, stagger, cutscenes, never for ordinary input.\n- A cancel window: an `Attack -> Dodge` edge with `Immediate`, `Auto` and a `can_cancel` condition that the attack clip's\n  method track switches on and off.\n- A new state machine already has `Start` and `End`; connect `Start -> Idle` with `Auto`, or call `Start(\"Idle\")` before the\n  first `Travel`.\n\n## 2. Blending\n\n- `AnimationNodeBlendSpace1D` (speed: idle, walk, run) and `AnimationNodeBlendSpace2D` (strafe), set through\n  `parameters\u002F\u003CName>\u002Fblend_position`. Name each blend point (`AddBlendPoint(node, pos, -1, \"walk\")`): 4.7 warns without one.\n  `SyncMode = CyclicMutable` keeps footsteps in phase (`Sync` is deprecated in 4.7). `BlendMode = Discrete` for frame-by-frame\n  2D sprites.\n- In a blend tree: `OneShot` for an upper-body attack or flinch over locomotion\n  (`parameters\u002F\u003CShot>\u002Frequest` = `(int)AnimationNodeOneShot.OneShotRequest.Fire`), `Transition`, `Blend2`, `TimeScale`.\n\n## 3. Root motion or in place\n\n| | In place (code moves the body) | Root motion (the clip moves it) |\n|---|---|---|\n| Feet | can slide; match speeds by hand | never slide |\n| Control | tune speed, acceleration and turning in code | tied to the clips; re-author to change |\n| Attacks, dodges, climbs | distance drifts from the art | exactly the authored distance |\n| Online play | simple to predict and reconcile | the server must run the same tree, deterministically |\n\nUse in-place locomotion and root motion only for short committed actions (lunges, dodges, vaults). Unreal's own guidance is\nthe same: root motion from montages only for networked games. In Godot set `RootMotionTrack` (e.g.\n`\"Skeleton3D:Root\"`), `CallbackModeProcess = Physics`, and apply it in `_PhysicsProcess`:\n\n```csharp\n\u002F\u002F RootMotionLocal = true on the tree.\nQuaternion *= _tree.GetRootMotionRotation();\nvar velocity = Quaternion * _tree.GetRootMotionPosition() \u002F (float)delta;\nvelocity.Y = Velocity.Y + (IsOnFloor() ? 0f : GetGravity().Y * (float)delta);   \u002F\u002F gravity stays yours\nVelocity = velocity;\nMoveAndSlide();\n```\n\n## 4. The twelve principles, for games\n\nFrom Thomas and Johnston's *The Illusion of Life*; review a key animation (an attack, a jump) against each.\n\n| Principle | In a game |\n|---|---|\n| Squash and stretch | jump take-off and landing, hit reactions, a pressed button; keep the volume |\n| Anticipation | the wind-up of a heavy attack is the player's dodge window; longer wind-up, bigger hit |\n| Staging | boss telegraphs: pose, colour flash, ground marker, camera; effects never hide the silhouette |\n| Straight ahead, pose to pose | pose to pose for gameplay clips with exact hit frames; straight ahead for fire and smoke |\n| Follow through, overlap | capes, hair, tails, a weapon trail that lingers, a recovery pose after the swing |\n| Slow in and slow out | `Tween` easing, `XfadeCurve`, camera moves |\n| Arcs | swings, lobs, jumps and head turns follow curves |\n| Secondary action | breathing, blinks (a `OneShot`), footstep dust, weapon sway |\n| Timing | frame counts for startup, active and recovery; hit-stop on big hits (its length: `game-juice`) |\n| Exaggeration | bigger flashes, knockback and poses than reality, so they read at gameplay zoom |\n| Solid drawing | weight and volume; no perfectly mirrored poses |\n| Appeal | a distinct silhouette for the player, each enemy and each boss |\n\nThe free references are Wikipedia's \"Twelve basic principles of animation\" and Alan Becker's video series; the book is *The\nAnimator's Survival Kit*.\n\n## 5. Prove it\n\n- [ ] a test builds or loads the tree and checks every state and transition the GDD names exists\n      (`AnimationNodeStateMachine.HasNode`, `HasTransition`), with each edge out of an attack set to `AtEnd`\n- [ ] a flow or bot run presses attack then move, and asserts the attack finished (`GetCurrentNode()` in the log)\n- [ ] the `juice` runner pairs each hit with its hit-stop and flash (`game-juice`)\n- [ ] screenshots of key poses at gameplay zoom, judged with `look`\n","# Animation in Godot 4\n\n`AnimationPlayer` holds the clips; `AnimationTree` decides which play and how they blend (both are `AnimationMixer`s). Notes,\ntests and sources: `${CLAUDE_PLUGIN_ROOT}\u002Fdocs\u002Fart.md`.\n\n## 1. A state machine with rules\n\nA tree whose root is an `AnimationNodeStateMachine`: Idle, Walk, Run, Jump, Fall, Attack. Each\n`AnimationNodeStateMachineTransition` has:\n\n| Property | Use |\n|---|---|\n| `SwitchMode` | `Immediate`; `Sync` (switch now, keep the play position: walk to run); `AtEnd` (wait for the clip to end) |\n| `AdvanceMode` | `Disabled` (never used); `Enabled` (only by `Travel`); `Auto` (taken by itself when its condition holds) |\n| `AdvanceCondition` | a bool parameter, `parameters\u002Fconditions\u002F\u003Cname>`; true only, so \"not moving\" is its own condition |\n| `AdvanceExpression` | an expression on `AdvanceExpressionBaseNode` (point it at the character), e.g. `is_on_floor()` |\n| `XfadeTime`, `XfadeCurve` | the blend between the two; 0.1 to 0.2 s for most moves |\n| `Priority` | lower wins when several auto transitions are open |\n\n```csharp\nvar playback = _tree.Get(\"parameters\u002Fplayback\").As\u003CAnimationNodeStateMachinePlayback>();\n_tree.Set(\"parameters\u002Fconditions\u002Fmoving\", Velocity.Length() > 0.1f);\nif (attackPressed) playback.Travel(\"Attack\");\n```\n\nInterruption rules, tested in 4.7.2:\n\n- `Travel(x)` follows a path over transitions that are not `Disabled`, ignoring conditions; each step keeps its own switch\n  mode. So a travel requested mid-attack waits when every edge out of Attack is `AtEnd`.\n- With no path, `Travel` jumps straight there, cutting an attack short. Wire every state you travel to.\n- `Start(x)` always cuts in at once: for death, stagger, cutscenes, never for ordinary input.\n- A cancel window: an `Attack -> Dodge` edge with `Immediate`, `Auto` and a `can_cancel` condition that the attack clip's\n  method track switches on and off.\n- A new state machine already has `Start` and `End`; connect `Start -> Idle` with `Auto`, or call `Start(\"Idle\")` before the\n  first `Travel`.\n\n## 2. Blending\n\n- `AnimationNodeBlendSpace1D` (speed: idle, walk, run) and `AnimationNodeBlendSpace2D` (strafe), set through\n  `parameters\u002F\u003CName>\u002Fblend_position`. Name each blend point (`AddBlendPoint(node, pos, -1, \"walk\")`): 4.7 warns without one.\n  `SyncMode = CyclicMutable` keeps footsteps in phase (`Sync` is deprecated in 4.7). `BlendMode = Discrete` for frame-by-frame\n  2D sprites.\n- In a blend tree: `OneShot` for an upper-body attack or flinch over locomotion\n  (`parameters\u002F\u003CShot>\u002Frequest` = `(int)AnimationNodeOneShot.OneShotRequest.Fire`), `Transition`, `Blend2`, `TimeScale`.\n\n## 3. Root motion or in place\n\n| | In place (code moves the body) | Root motion (the clip moves it) |\n|---|---|---|\n| Feet | can slide; match speeds by hand | never slide |\n| Control | tune speed, acceleration and turning in code | tied to the clips; re-author to change |\n| Attacks, dodges, climbs | distance drifts from the art | exactly the authored distance |\n| Online play | simple to predict and reconcile | the server must run the same tree, deterministically |\n\nUse in-place locomotion and root motion only for short committed actions (lunges, dodges, vaults). Unreal's own guidance is\nthe same: root motion from montages only for networked games. In Godot set `RootMotionTrack` (e.g.\n`\"Skeleton3D:Root\"`), `CallbackModeProcess = Physics`, and apply it in `_PhysicsProcess`:\n\n```csharp\n\u002F\u002F RootMotionLocal = true on the tree.\nQuaternion *= _tree.GetRootMotionRotation();\nvar velocity = Quaternion * _tree.GetRootMotionPosition() \u002F (float)delta;\nvelocity.Y = Velocity.Y + (IsOnFloor() ? 0f : GetGravity().Y * (float)delta);   \u002F\u002F gravity stays yours\nVelocity = velocity;\nMoveAndSlide();\n```\n\n## 4. The twelve principles, for games\n\nFrom Thomas and Johnston's *The Illusion of Life*; review a key animation (an attack, a jump) against each.\n\n| Principle | In a game |\n|---|---|\n| Squash and stretch | jump take-off and landing, hit reactions, a pressed button; keep the volume |\n| Anticipation | the wind-up of a heavy attack is the player's dodge window; longer wind-up, bigger hit |\n| Staging | boss telegraphs: pose, colour flash, ground marker, camera; effects never hide the silhouette |\n| Straight ahead, pose to pose | pose to pose for gameplay clips with exact hit frames; straight ahead for fire and smoke |\n| Follow through, overlap | capes, hair, tails, a weapon trail that lingers, a recovery pose after the swing |\n| Slow in and slow out | `Tween` easing, `XfadeCurve`, camera moves |\n| Arcs | swings, lobs, jumps and head turns follow curves |\n| Secondary action | breathing, blinks (a `OneShot`), footstep dust, weapon sway |\n| Timing | frame counts for startup, active and recovery; hit-stop on big hits (its length: `game-juice`) |\n| Exaggeration | bigger flashes, knockback and poses than reality, so they read at gameplay zoom |\n| Solid drawing | weight and volume; no perfectly mirrored poses |\n| Appeal | a distinct silhouette for the player, each enemy and each boss |\n\nThe free references are Wikipedia's \"Twelve basic principles of animation\" and Alan Becker's video series; the book is *The\nAnimator's Survival Kit*.\n\n## 5. Prove it\n\n- [ ] a test builds or loads the tree and checks every state and transition the GDD names exists\n      (`AnimationNodeStateMachine.HasNode`, `HasTransition`), with each edge out of an attack set to `AtEnd`\n- [ ] a flow or bot run presses attack then move, and asserts the attack finished (`GetCurrentNode()` in the log)\n- [ ] the `juice` runner pairs each hit with its hit-stop and flash (`game-juice`)\n- [ ] screenshots of key poses at gameplay zoom, judged with `look`\n",{"name":5,"description":7},"main","5fa4c2262d814d50f72198a95b8c483ff195f90f",".agents\u002Fskills\u002Fanimation",0,"https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot","https:\u002F\u002Fnick-vas.github.io\u002Fhyperdot\u002F","https:\u002F\u002Fgithub.com\u002Fnick-vas","https:\u002F\u002Fcommon-beef.itch.io\u002F","2026-11-13 18:55:29",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add nick-vas\u002Fhyperdot --skill animation",{"tool":39,"command":40},"bunx","bunx skills add nick-vas\u002Fhyperdot --skill animation",{"tool":42,"command":43},"pnpm","pnpm dlx skills add nick-vas\u002Fhyperdot --skill animation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fanimation\u002FSKILL.md",true,[],[48,55,61,68,75,82],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M7E6RF2S03S92PB9RZB4S4W0","over-budget","Use when a fixture exceeds the size budget.","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002Ftests\u002Fskill-fixtures\u002Fover-budget\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7E6RBY8SDNMA3ZARE8MAH0G","bad-yaml","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002Ftests\u002Fskill-fixtures\u002Fbad-yaml\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7E6R9S9YHTC552SR41RQAJ1","bad-workflow-description","Use when testing; runs the kit and then reads the JSON.","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002Ftests\u002Fskill-fixtures\u002Fbad-workflow-description\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7E6R6CWSAN48C80130CM1AK","bad-version","Use when a fixture quotes a stale package version.","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002Ftests\u002Fskill-fixtures\u002Fbad-version\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7E6R2C0E24TC133ESHKZT9R","bad-value","Use when a fixture passes a value outside a parameter's set.","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002Ftests\u002Fskill-fixtures\u002Fbad-value\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7E6QYM81V061X7DSQ94CZRP","bad-trigger","Helps with Godot tests.","https:\u002F\u002Fgithub.com\u002Fnick-vas\u002Fhyperdot\u002Fblob\u002Fmain\u002Ftests\u002Fskill-fixtures\u002Fbad-trigger\u002FSKILL.md",[],[]]