unity-animator
Edit Unity Animator Controllers and drive runtime parameters
Install / Use
npx skills add Besty0728/Unity-Skills --skill animatorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of unity-animator
unity-animator scores 86/100 on our quality scale, 2393rd of 4,698 Development & Engineering skills we index.
Its SKILL.md is 9.2 KB long, well organised into 25 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-animator is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- 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. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-animator compared with similar skills
All 4 of these similar skills score higher than unity-animator; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-animator (this skill)by Besty0728 | 86 | 1.8k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install unity-animator?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-animator. The install tabs above show the steps for each supported agent. - Which AI agents does unity-animator 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 unity-animator safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. 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 unity-animator still maintained?
- The repository was last updated about 2 months ago, so unity-animator is actively maintained.
Skill content
View source on GitHubname: unity-animator description: Edit Unity Animator Controllers and drive runtime parameters
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Setting up or wiring an Animator
- Adjusting animation state machines
- Driving animation parameters at runtime
- 搭建或连接 Animator、调整动画状态机、运行时驱动动画参数
Unity Animator Skills
Control Unity's Mecanim system — create Animator Controllers, add layers' states / transitions / parameters, assign controllers to GameObjects, set parameters at runtime, and play states.
Operating Mode
- Approval:查询类 skill(
animator_get_parameters/animator_get_info/animator_list_states,源码标SkillMode.SemiAuto)直接执行;其余变更类(create_controller / add_parameter / set_parameter / play / assign_controller / add_state / add_transition,标SkillMode.FullAuto)需用户 grant,grant 后服务端一步执行返结果。 - Auto / Bypass:所有 skill 直接执行;Auto 走 AI 自我评估,Bypass 全放行。
- 本模块不含 Delete / PlayMode / Reload / 高危 skill,无 Bypass-only 拦截项。
animator_set_parameter/animator_play作用于场景中已挂 Animator 的 GameObject;如果当前不在 Play mode,状态机只在 Editor 预览模式推进,效果与 runtime 不完全等价。
DO NOT (common hallucinations):
animator_create_clip/animator_add_clipdo not exist → AnimationClips are created via Unity Editor or asset importanimator_set_speeddoes not exist → usecomponent_set_propertyon Animator component with propertyName="speed"
Routing:
- For Timeline animation → use
timelinemodule - For component properties on Animator → use
componentmodule - For animation import settings → use
importermodule
Skills Overview
| Skill | Description |
|-------|-------------|
| animator_create_controller | Create new Animator Controller |
| animator_add_parameter | Add parameter to controller |
| animator_get_parameters | List all parameters |
| animator_set_parameter | Set parameter value at runtime |
| animator_play | Play animation state |
| animator_get_info | Get Animator component info |
| animator_assign_controller | Assign controller to GameObject |
| animator_list_states | List states in controller |
| animator_add_state | Add a state to a controller layer |
| animator_add_transition | Add a transition between two states |
Parameter Types
| Type | Description | Example Use |
|------|-------------|-------------|
| float | Decimal value | Speed, blend weights |
| int | Integer value | State index |
| bool | True/false | IsGrounded, IsRunning |
| trigger | One-shot signal | Jump, Attack |
Skills
animator_create_controller
Create a new Animator Controller.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | Yes | - | Controller name |
| folder | string | No | "Assets/Animations" | Save folder |
Returns: {success, name, path}
animator_add_parameter
Add a parameter to a controller.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| controllerPath | string | Yes | - | Controller asset path |
| paramName | string | Yes | - | Parameter name |
| paramType | string | Yes | - | float/int/bool/trigger |
| defaultFloat | float | No | 0 | Initial float value |
| defaultInt | int | No | 0 | Initial int value |
| defaultBool | bool | No | false | Initial bool value |
animator_get_parameters
Get all parameters from a controller.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| controllerPath | string | Yes | Controller asset path |
Returns: {controller, parameters: [{name, type, defaultFloat, defaultInt, defaultBool}]}
animator_set_parameter
Set a parameter value at runtime (supports name/instanceId/path).
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | GameObject instance ID |
| path | string | No* | GameObject hierarchy path |
| paramName | string | Yes | Parameter name |
| paramType | string | Yes | float/int/bool/trigger |
| floatValue | float | No* | Float value |
| intValue | int | No* | Integer value |
| boolValue | bool | No* | Boolean value |
*At least one identifier required. Use the appropriate value for paramType (trigger doesn't need a value).
animator_play
Play a specific animation state (supports name/instanceId/path).
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No* | - | GameObject name |
| instanceId | int | No* | 0 | GameObject instance ID |
| path | string | No* | null | GameObject hierarchy path |
| stateName | string | Yes | - | Animation state name |
| layer | int | No | 0 | Animator layer |
| normalizedTime | float | No | 0 | Start time (0-1) |
*At least one identifier required.
animator_get_info
Get Animator component information (supports name/instanceId/path).
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No | null | GameObject name |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | null | GameObject hierarchy path |
Returns: {gameObject, instanceId, hasController, controllerPath, speed, applyRootMotion, updateMode, cullingMode, layerCount, parameterCount}
animator_assign_controller
Assign a controller to a GameObject (supports name/instanceId/path).
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | GameObject instance ID |
| path | string | No* | GameObject hierarchy path |
| controllerPath | string | Yes | Controller asset path |
*At least one identifier required.
animator_list_states
List all states in a controller layer.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| controllerPath | string | Yes | - | Controller asset path |
| layer | int | No | 0 | Layer index |
Returns: {controller, layer, layerName, stateCount, states: [{name, tag, speed, hasMotion}]}
animator_add_state
Add a state to an Animator Controller layer.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| controllerPath | string | Yes | - | Controller asset path |
| stateName | string | Yes | - | Name for the new state |
| clipPath | string | No | null | Animation clip asset path to assign |
| layer | int | No | 0 | Layer index |
Returns: {success, controller, stateName, layer}
animator_add_transition
Add a transition between two states in an Animator Controller.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| controllerPath | string | Yes | - | Controller asset path |
| fromState | string | Yes | - | Source state name |
| toState | string | Yes | - | Destination state name |
| layer | int | No | 0 | Layer index |
| hasExitTime | bool | No | true | Whether transition waits for exit time |
| duration | float | No | 0.25 | Transition duration in seconds |
Returns: {success, from, to, layer, hasExitTime, duration}
Example: Complete Animation Setup
import unity_skills
# 1. Create controller
unity_skills.call_skill("animator_create_controller",
name="PlayerController",
folder="Assets/Animations"
)
# 2. Add parameters
unity_skills.call_skill("animator_add_parameter",
controllerPath="Assets/Animations/PlayerController.controller",
paramName="Speed", paramType="float", defaultFloat=0
)
unity_skills.call_skill("animator_add_parameter",
controllerPath="Assets/Animations/PlayerController.controller",
paramName="IsGrounded", paramType="bool", defaultBool=True
)
unity_skills.call_skill("animator_add_parameter",
controllerPath="Assets/Animations/PlayerController.controller",
paramName="Jump", paramType="trigger"
)
# 3. Assign to character
unity_skills.call_skill("animator_assign_controller",
name="Player",
controllerPath="Assets/Animations/PlayerController.controller"
)
# 4. Control at runtime
unity_skills.call_skill("animator_set_parameter",
name="Player", paramName="Speed", paramType="float", floatValue=5.0
)
# Trigger jump
unity_skills.call_skill("animator_set_parameter",
name="Player", paramName="Jump", paramType="trigger"
)
# Play specific state
unity_skills.call_skill("animator_play", name="Player", stateName="Idle")
Best Practices
- Create controller before adding parameters
- Use meaningful parameter names
- Triggers reset automatically after firing
- Set parameters before playing states
- Use layers for independent animations (body + face)
- States must exist in controller before playing
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe 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.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
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.
