scenario-roblox-animation
Use when animating Roblox characters, NPCs or creatures: animation not playing, wrong animation wins, animation priority or weight, blending, animation events and markers, hit timing, import from Blender or FBX, custom rig or creature rig, Motor6D or AnimationConstraint joints, procedural animation,…
Install / Use
npx skills add scenario-labs/skills --skill scenario-roblox-animationInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of scenario-roblox-animation
scenario-roblox-animation scores 86/100 on our quality scale, 2383rd of 4,705 Development & Engineering skills we index.
Its SKILL.md is 18 KB long, well organised into 10 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-roblox-animation is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-roblox-animation compared with similar skills
All 4 of these similar skills score higher than scenario-roblox-animation; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-roblox-animation (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 73.0k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.5k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install scenario-roblox-animation?
- Run
npx skills add scenario-labs/skills --skill scenario-roblox-animation. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-roblox-animation work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-roblox-animation safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-roblox-animation still maintained?
- The repository was last updated 35 days ago, so scenario-roblox-animation is actively maintained.
Skill content
View source on GitHubname: scenario-roblox-animation description: "Use when animating Roblox characters, NPCs or creatures: animation not playing, wrong animation wins, animation priority or weight, blending, animation events and markers, hit timing, import from Blender or FBX, custom rig or creature rig, Motor6D or AnimationConstraint joints, procedural animation, IKControl look-at or foot and hand IK, FaceControls and dynamic head expressions, replacing the default Animate animations, KeyframeSequence or CurveAnimation built in code, Animator replication, AnimationController NPCs, Character Controller Library abilities, adaptive animation for custom humanoids." license: MIT
Roblox animation and characters
Target line: Roblox Studio (October 2026 build) on macOS, driven through the scenario-roblox-expert toolkit.
Expert level here means every clip, layer, IK chain and face is proven in Studio by numbers: which
track wins each joint, when each marker fires, what the server sees, and that the stepped pose
matches its source. An agent cannot drive the Animation Editor, so it builds clips in code, steps
them in Edit, plays them in a playtest and measures joints and tracks before it calls anything done.
If a sibling skill named here is missing from your available skills, load it with skill_get
(Scenario MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install);
unattended, proceed from tool schemas and flag the gap.
REQUIRED BACKGROUND: scenario-roblox-expert (channels, review loop, toolkit, current-Roblox traps).
Stance (the expert delta)
- Avatar joints are
AnimationConstraint, notMotor6D. The Avatar Joint Upgrade made R15C0andC1read-only (L1, L8). Procedural motion multiplies intoTransformin PreSimulation, which applies as a deferred batch and does not replicate (Suphi Kaner, BRYp2-rdpXQ 00:00:33). Code that looks joints up must accept both classes. - Load through the
Animator, from the side that owns the rig. The owning client plays its character's tracks and the server sees them (L6); the server plays NPC tracks and clients see them (L7).Humanoid:LoadAnimationis deprecated. - Priority partitions joints; keys claim them. A higher priority wins only the joints it keys, and an identity key still claims its joint (L4). In clips built in code, parent Poses that are only on the path need Weight 0, or they override lower tracks [added] (L4).
- Time gameplay with markers, never waits. Use one event name with a parameter (Develuper,
d5GGIJJyMpg 00:02:52).
GetMarkerReachedSignalfired within one frame (L6);KeyframeReachedneeds named keyframes (BrawlDev, zSK7bOoxuig 00:25:25). - Faces play as clips, not property writes. On a player's dynamic head, a
FaceControlswrite or a finished tween reverts to 0 within 0.5 s, even with every track stopped [added] (L10, L16). A face clip holds, replicates, and survives the mood animation. - IKControls are created on the server; look-at weight is 0.999. At weight 1 the neck twists
when the target passes behind;
IKControl.Priorityorders the solves;Poleis set from code (Suphi Kaner, 8fV-XOOj6O4 00:18:56, 00:53:00, 00:54:40). - Blender clips are 24 fps, armature only, no scale keys. Leaf bones, NLA strips and All Actions go off; Force Start/End Keying and Simplify 0 stay on (Mykaiju, NI7GXKLwk6U 00:23:45 to 00:27:07). 60 fps doubles the keys for no gain in gameplay (Nisky, EM9u4gIHoRg 00:07:55).
- Temporary ids are test fixtures.
RegisterKeyframeSequencehashes andactive://ids work in Studio only; the shipped game references publishedrbxassetid://ids owned by the experience owner (Animation Editor docs).
Establish first
- Rig kind. R15 avatar (AnimationConstraint, BallSocket limits), custom part rig (Motor6D), skinned mesh (Bones), or AnimationController creature. Run P1 instead of guessing.
- Who plays what. Player clips on the client, NPC clips on the server, cosmetic layers locally.
- Server Authority. When on, an Animator keeps at most 8 active tracks, and tracks are looked up
each tick with
GetTrackByAnimationId, never cached. - Character Controller Library. When on, movement comes from
ControllerManagerand abilities; ability callbacks never yield. - Faces. Is there a dynamic head (
HeadhasFaceControls)? - Motion source. Blender FBX, a Scenario-generated rig or motion, the Animation Editor, or code.
- Publishing owner. User or group; clips must be published under the experience owner.
- Defaults: R15, Action for gameplay clips, Idle and Movement for locomotion, 24 fps, markers named after the event with a parameter.
Procedure
Code for every step is in references/procedures.md (P1 to P15), with the test that ran it and its
numbers.
- Inspect the rig (P1). Run
AnimRig.joints,AnimRig.treeandAnimRig.pathon the model. GATE: joint classes are known, every animated part has a path from the root, and an Animator exists. - Build or bring the clips (P2, P3, P10). Code clips use
AnimClip.keyframesorAnimClip.curves, are registered withAnimClip.registerand loaded withAnimClip.load, which waits forLength > 0. Blender clips go throughblender_roblox_anim.py(audit, export, sample) andAnimClip.fromSamples. GATE: stepped joint angles match the keys within 0.3 degrees; Blender bone tails match within 0.01 studs. - Layer and time (P4). Set priorities, weights and fades; key only the joints each clip owns;
put markers on contact frames. GATE:
AnimClip.tracks(animator)shows the intended winner per joint, and each marker fires once per cycle. - Preview in Edit (P5). Call
AnimClip.settlefirst: a clip that ended on its own still blends into the next one (P3).rbx_animation.pose_sheetsteps a track withAnimator:StepAnimations, captures each time and builds one contact sheet. GATE: read the sheet; the frame differences are above zero;AnimRig.resetleaves no posed joint before the place is saved. - Playtest (P6, P8). Play player clips from the client and NPC clips from the server; read the joints on both sides. GATE: the server finds the client's track, both sides report the same joint angle, and a capture shows the pose.
- Layers, IK and faces (P9, P12, P7). Procedural offsets go into
Transformin PreSimulation and skip whenAnimator.EvaluationThrottledis true. IK comes fromAnimIK.reachandAnimIK.lookAt; faces fromAnimFace.clip. GATE: the measured neck yaw, IK gap and face values on the server, plus a capture each. - Defaults and audit (P13, P14). Replace default animations through the
Animatevalues; runAnimAudit.all. GATE: no error or warning finding; after a state change the client plays the new clip, checked byLengthand joint angle, not by id. - Publish list. List every clip to publish, its priority, loop and markers, and the owner.
GATE: no temporary id in shipped code (
AnimAuditruletemp-animation-id).
Numbers
| Value | Number | Relative to |
| ------------------------------ | -------------------------------------------------------------------------------- | -------------------------------- |
| Priority order | Core < Idle < Movement < Action < Action2 < Action3 < Action4 | Enum.AnimationPriority |
| Default Animate tracks | idle at Core, mood at Idle | L6, player avatar |
| Fade | Play(0.4) ramps weight 0.25 per 0.1 s | L4 |
| Same-priority blend | weighted mean: 90 and 60 degrees give 75 at equal weights, 84 at 1 and 0.25 | L4 |
| Action at weight 0.5 over Idle | 60 degrees between 90 and 30 | L4 |
| Marker at 0.25 s of playback | fired at 266 ms, frame 16.3 ms | L6, speed 2 |
| Stopped and Ended | 500 and 816 ms for a 0.5 s playback | L6 |
| Natural end, then a new clip | old pose blends in for 0.25 to 0.375 s (31.8 instead of 22.5 degrees at 0.25 s) | L3 |
| First load | Length 0 at LoadAnimation, 14 ms to load in Edit | L2 |
| Neck layer of 45 degrees | 41.9 degrees on the joint, head 45.5 degrees off the root | L8 |
| IK reach | hand 0.20 to 0.23 studs from a reachable target within 0.1 s, same on the client | L9 |
| IK limits | 4.17 studs from an unreachable target; 1.13 at Weight 0.5 | L9 |
| IK SmoothTime 0.5 | gap 1.81 to 0.37 studs over 0.6 s | L9 |
| Look-at | Weight 0.999; head within 0.05 degrees of the target | L9; Suphi Kaner |
| Face write or tween | back to 0 within 0.5 s | L10 |
| Face clip | JawDrop 0.55 on client and server; the open mouth shows in the capture | L10 |
| Blender to Studio | worst bone-tail error 0.0002 studs, 10 bones, 25 frames | L12 |
| Skin weights | at most 4 influences per vertex | skinning docs |
| Server Authority | at most 8 active tracks per Animator | Server Authority docs |
| Dynamic head | 4,000 triangles; validation checks 5 animations from 17 FACS poses | specs; Roblox Learn, OwhkWzSBnf0 |
Quality gates
Measurable:
AnimAudit.all(game)returns no error and no warning (P14).- Every track the code plays reports
Length > 0, the intended priority andWeightCurrent1 at rest (AnimClip.tracks). - Each marker the code listens to fires once per cycle at its time, within one frame.
- Server and client report the same joint angles for replicated tracks.
- Blender exports pass
auditwith no finding, and P10's tail error is under 0.01 studs. AnimRig.dirtyis empty on every rig before the place is saved.
Visual (contact sheets of at most 1,600 px, rbx_review.contact_sheet):
- Pose sheet of each clip at 4 to 6 times: silhouettes read, arcs, no interpenetration, closed loop.
- Playtest captures: player clip, NPC clip, IK reach with the target visible, face close-up next to a neutral capture.
- Judge with
references/critique.md.
Common mistakes
| Mistake | Symptom | Fix | | ------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | Clip at Core or Idle | plays but the default idle wins
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ai-job-search
73.0kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.5kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
