Exécutez n'importe quel Skill dans Manus
en un clic

Exécutez n'importe quel Skill dans Manus en un clic

animation-editing

Étoiles420

Forks91

Mis à jour24 juin 2026 à 01:51

Preview, validate, and bake bone-rotation edits on AnimSequences with constraint awareness and retarget safety. Use when the user asks to edit/pose/adjust an animation's bones, raise an arm, create a swing/wave/dance/pose, mirror or copy a pose, set joint limits, or learn bone constraints. Load together with animsequence (keyframes) and skeleton (structure).

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Exécuter dans Manus

Source

kevinpbuckley

kevinpbuckley/VibeUE

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Exécuter dans Manus

Explorateur de fichiers

9 fichiers

SKILL.md

readonly

name	animation-editing
display_name	Animation Editing & Bone Space Correctness
description	Preview, validate, and bake bone-rotation edits on AnimSequences with constraint awareness and retarget safety. Use when the user asks to edit/pose/adjust an animation's bones, raise an arm, create a swing/wave/dance/pose, mirror or copy a pose, set joint limits, or learn bone constraints. Load together with animsequence (keyframes) and skeleton (structure).
vibeue_classes	["AnimSequenceService","SkeletonService"]
unreal_classes	["AnimSequence","Skeleton","SkeletalMesh"]
keywords	["animation editing","bone rotation","bone space","local space","component space","constraint","joint limit","preview","validate","bake","keyframe","retarget","pose","mirror","copy pose","create animation","swing","wave","dance","arm raise"]
related_skills	["animsequence","skeleton","animation-blueprint"]

🧠 Brains complement: IF an unreal-engine-skills-manager tool (external MCP) exists in this session, call it with {action: "load", skill: "animation-system"} for UE domain knowledge on this topic — correct APIs, architecture, best practices — and treat it as the rubric for any review / "best practices" question. If no such tool is available (e.g. running under Claude Code or Codex without that MCP), skip this line entirely and proceed with this skill alone — do NOT attempt the call.

Animation Editing Skill

Covers the profile → preview → validate → bake workflow for safe bone edits with correct bone-space handling and constraint validation.

Load companion skills: animsequence (basic keyframe creation), skeleton (structure, retargeting), animation-blueprint (state machines / AnimGraph). Skills load via the engine's AgentSkillToolset (ListSkills / GetSkills) — there is no vibeue-skills-manager tool. Run the VibeUE services below with execute_python_code (unreal.<Service>.<method>()).

🛡️ Safe discovery — never unreal.load_asset() in loops (memory crash 0xC0000005). Use SkeletonService.list_skeletons(path), AnimSequenceService.find_animations_for_skeleton(skeleton), AnimSequenceService.list_anim_sequences(path, skeleton_filter) — they query metadata without loading.

⚠️ Critical Rules

1. Always specify bone space

Every bone rotation must state its coordinate space. Default to "local" for user intent.

Space	Relative to	Use for
`"local"`	parent bone	most edits (default)
`"component"`	mesh root	cross-bone coordination
`"world"`	world	rarely

unreal.AnimSequenceService.preview_bone_rotation(path, "upperarm_r", unreal.Rotator(0, 30, 0), "local", 0)

2. Use preview → validate → bake (never edit blind)

ass = unreal.AnimSequenceService
ass.preview_bone_rotation(anim_path, "upperarm_r", unreal.Rotator(0, 45, 0), "local", 0)
v = ass.validate_pose(anim_path, True)             # True = learned constraints
if v.is_valid:
    ass.bake_preview_to_keyframes(anim_path, 0, -1, "cubic")
else:
    ass.cancel_preview(anim_path)                  # or accept clamped values

3. Build a skeleton profile before editing

profile = unreal.SkeletonService.create_skeleton_profile("/Game/SK_Mannequin")
if not profile.has_learned_constraints:
    unreal.SkeletonService.learn_from_animations("/Game/SK_Mannequin", 50, 10)

Without a profile there are no constraints to validate against.

4. Euler for intent, quaternions internally

Express user intent as unreal.Rotator(roll, pitch, yaw) (degrees); the service uses quaternions internally to avoid gimbal lock. Inspect with quat_to_euler(quat). Don't guess axis orientation — read the reference pose first (get_reference_pose).

Task Index

Task	Workflow	Sample script
Discover skeletons/animations safely	`workflows.md` → Inspect skeleton	`scripts/safe_discovery.txt`
Build a skeleton profile	`workflows.md` → Inspect skeleton	—
Edit one bone (preview/validate/bake)	`workflows.md` → single bone edit	`scripts/preview_validate_bake.txt`
Edit a bone chain atomically	`workflows.md` → multi-bone edit	`scripts/multi_bone_edit.txt`
Set manual joint constraints	`workflows.md` → set constraints	—
Learn constraints from animations	`workflows.md` → learn constraints	`scripts/learn_constraints.txt`
Copy / mirror a pose	`workflows.md` → copy/mirror	`scripts/mirror_pose.txt`
Retarget preview	`workflows.md` → retargeting	—

Sub-docs

workflows.md — step-by-step workflows for every task above.
api-reference.md — full SkeletonService/AnimSequenceService method list + data structures.
common-mistakes.md — bone-space, validation, axis-guessing, and the load-in-loops crash.

Verification

Confirm AnimationEditResult.success and inspect was_clamped; gate baking on validate_pose(...).is_valid; cancel_preview on failure; save_asset after a successful bake.

Plus depuis ce dépôt

même dépôt

animation-blueprint

kevinpbuckley/VibeUE

Navigate, inspect, and author Animation Blueprints — state machines, states, transitions, and transition rules (AnimGraphService). Use when the user asks to create or edit an Animation Blueprint/AnimBP, add a state machine or states, wire transitions between states, set a state's animation, or inspect AnimGraph structure.

2026-06-24420

animation-montage

kevinpbuckley/VibeUE

Create and manipulate Animation Montages — sections, slots, segments, branching points, notifies, and blend settings (AnimMontageService). Use when the user asks to create a montage (from an animation or empty), add or link montage sections, set up slots/segments, add branching points, or adjust montage blend timing.

2026-06-24420

animsequence

kevinpbuckley/VibeUE

Create and edit AnimSequence keyframes and tracks — add/remove keyframes, set bone tracks, query sequence info, and bake edits (AnimSequenceService). Use when the user asks to create a new animation sequence, add keyframes/tracks, or edit raw animation data. For constraint-aware bone posing, also load animation-editing.

2026-06-24420

asset-management

kevinpbuckley/VibeUE

Import/export textures crash-safely, query the Content Browser selection, and check if an asset is open (AssetDiscoveryService). Search, load, save, move, rename, duplicate, and delete assets are handled by Unreal's native AssetTools toolset or EditorAssetLibrary. Use when the user asks to import an image from disk, export a texture, query the Content Browser selection, or check whether an asset is open in an editor.

2026-06-24420

blueprint-graphs

kevinpbuckley/VibeUE

Add, connect, and configure nodes in Blueprint event graphs and function graphs — function-call/event/branch/timer/custom-event/delegate nodes, Standard Macro nodes (ForEachLoop/ForLoop/WhileLoop/DoOnce/Gate/IsValid/FlipFlop via add_macro_instance_node), macro-graph creation, pin wiring, node layout, arrays, comment boxes, and the batch build_graph API. Use when the user asks to wire up Blueprint logic, add or connect nodes, add a loop/macro node, build an event graph, set up a timer/delay, broadcast a delegate, or lay out an existing graph.

2026-06-24420

blueprints

kevinpbuckley/VibeUE

Create and modify Blueprint assets, variables, functions, components, event dispatchers, and interfaces. Use when the user asks to create a Blueprint/BP, add a variable or component to a Blueprint, make an event dispatcher/delegate, implement a Blueprint interface, or inspect a Blueprint's class/components. For node-level graph wiring, also load blueprint-graphs.

2026-06-24420

name	animation-editing
display_name	Animation Editing & Bone Space Correctness
description	Preview, validate, and bake bone-rotation edits on AnimSequences with constraint awareness and retarget safety. Use when the user asks to edit/pose/adjust an animation's bones, raise an arm, create a swing/wave/dance/pose, mirror or copy a pose, set joint limits, or learn bone constraints. Load together with animsequence (keyframes) and skeleton (structure).
vibeue_classes	["AnimSequenceService","SkeletonService"]
unreal_classes	["AnimSequence","Skeleton","SkeletalMesh"]
keywords	["animation editing","bone rotation","bone space","local space","component space","constraint","joint limit","preview","validate","bake","keyframe","retarget","pose","mirror","copy pose","create animation","swing","wave","dance","arm raise"]
related_skills	["animsequence","skeleton","animation-blueprint"]

🧠 Brains complement: IF an unreal-engine-skills-manager tool (external MCP) exists in this session, call it with {action: "load", skill: "animation-system"} for UE domain knowledge on this topic — correct APIs, architecture, best practices — and treat it as the rubric for any review / "best practices" question. If no such tool is available (e.g. running under Claude Code or Codex without that MCP), skip this line entirely and proceed with this skill alone — do NOT attempt the call.

Animation Editing Skill

Covers the profile → preview → validate → bake workflow for safe bone edits with correct bone-space handling and constraint validation.

Load companion skills: animsequence (basic keyframe creation), skeleton (structure, retargeting), animation-blueprint (state machines / AnimGraph). Skills load via the engine's AgentSkillToolset (ListSkills / GetSkills) — there is no vibeue-skills-manager tool. Run the VibeUE services below with execute_python_code (unreal.<Service>.<method>()).

🛡️ Safe discovery — never unreal.load_asset() in loops (memory crash 0xC0000005). Use SkeletonService.list_skeletons(path), AnimSequenceService.find_animations_for_skeleton(skeleton), AnimSequenceService.list_anim_sequences(path, skeleton_filter) — they query metadata without loading.

⚠️ Critical Rules

1. Always specify bone space

Every bone rotation must state its coordinate space. Default to "local" for user intent.

Space	Relative to	Use for
`"local"`	parent bone	most edits (default)
`"component"`	mesh root	cross-bone coordination
`"world"`	world	rarely

unreal.AnimSequenceService.preview_bone_rotation(path, "upperarm_r", unreal.Rotator(0, 30, 0), "local", 0)

2. Use preview → validate → bake (never edit blind)

ass = unreal.AnimSequenceService
ass.preview_bone_rotation(anim_path, "upperarm_r", unreal.Rotator(0, 45, 0), "local", 0)
v = ass.validate_pose(anim_path, True)             # True = learned constraints
if v.is_valid:
    ass.bake_preview_to_keyframes(anim_path, 0, -1, "cubic")
else:
    ass.cancel_preview(anim_path)                  # or accept clamped values

3. Build a skeleton profile before editing

profile = unreal.SkeletonService.create_skeleton_profile("/Game/SK_Mannequin")
if not profile.has_learned_constraints:
    unreal.SkeletonService.learn_from_animations("/Game/SK_Mannequin", 50, 10)

Without a profile there are no constraints to validate against.

4. Euler for intent, quaternions internally

Task Index

Task	Workflow	Sample script
Discover skeletons/animations safely	`workflows.md` → Inspect skeleton	`scripts/safe_discovery.txt`
Build a skeleton profile	`workflows.md` → Inspect skeleton	—
Edit one bone (preview/validate/bake)	`workflows.md` → single bone edit	`scripts/preview_validate_bake.txt`
Edit a bone chain atomically	`workflows.md` → multi-bone edit	`scripts/multi_bone_edit.txt`
Set manual joint constraints	`workflows.md` → set constraints	—
Learn constraints from animations	`workflows.md` → learn constraints	`scripts/learn_constraints.txt`
Copy / mirror a pose	`workflows.md` → copy/mirror	`scripts/mirror_pose.txt`
Retarget preview	`workflows.md` → retargeting	—

Sub-docs

workflows.md — step-by-step workflows for every task above.
api-reference.md — full SkeletonService/AnimSequenceService method list + data structures.
common-mistakes.md — bone-space, validation, axis-guessing, and the load-in-loops crash.

Verification

Confirm AnimationEditResult.success and inspect was_clamped; gate baking on validate_pose(...).is_valid; cancel_preview on failure; save_asset after a successful bake.