skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills90 installs

unity-animator

Edit Unity Animator Controllers and drive runtime parameters

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-animator
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The unity-animator skill provides tools for managing Unity Animator Controllers through a local API. It allows for creating controllers, adding states and transitions, and driving animation parameters at runtime. The skill contains a low-risk indirect prompt injection surface because it processes untrusted user-supplied strings like state names and file paths within commands sent to the local Unity server.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Unity Animator Skills

Create Animator Controllers, add states, transitions and parameters, assign controllers to GameObjects, set parameters at runtime and play states. Parameters come from the schema (GET /skills/schema?category=Animator&wire=v2); execution and dryRun rules: root SKILL.md.

When to use

  • Setting up or wiring an Animator
  • Adjusting animation state machines
  • Driving animation parameters at runtime

Rules

  • Query skills (animator_get_parameters, animator_get_info, animator_list_states) are read-only and run under Approval; the writers and animator_play need a grant there.
  • animator_set_parameter and animator_play act on the Animator of a scene GameObject. Outside Play Mode the state machine advances only in the editor's preview, which does not match runtime exactly.
  • Triggers reset automatically after they fire.
  • Set parameters before playing states, and create the controller before adding parameters.
  • States must exist in the controller before animator_play can use them.
  • animator_add_parameter applies only the default that matches paramType.
  • For Timeline animation, use timeline; for Animator component properties, use component; for animation import settings, use importer.

Pitfalls

  • animator_create_clip and animator_add_clip do not exist: AnimationClips come from the Unity Editor or asset import.
  • animator_set_speed does not exist: set the speed property with component_set_property on the Animator.

Example: setup, then drive at runtime

Add the state before playing it: a new controller has no states, so animator_play on an unadded state fails.

u="http://localhost:<port>/skill"; p="expectProject=<project>"; C=Assets/Animations/PlayerController.controller
curl -s "$u/animator_create_controller?$p" -d '{"name":"PlayerController","folder":"Assets/Animations"}'
curl -s "$u/animator_add_parameter?$p" -d "{\"controllerPath\":\"$C\",\"paramName\":\"Speed\",\"paramType\":\"float\"}"
curl -s "$u/animator_add_parameter?$p" -d "{\"controllerPath\":\"$C\",\"paramName\":\"Jump\",\"paramType\":\"trigger\"}"
curl -s "$u/animator_add_state?$p" -d "{\"controllerPath\":\"$C\",\"stateName\":\"Idle\"}"
curl -s "$u/animator_assign_controller?$p" -d "{\"name\":\"Player\",\"controllerPath\":\"$C\"}"
curl -s "$u/animator_set_parameter?$p" -d '{"name":"Player","paramName":"Speed","paramType":"float","floatValue":5.0}'
curl -s "$u/animator_set_parameter?$p" -d '{"name":"Player","paramName":"Jump","paramType":"trigger"}'
curl -s "$u/animator_play?$p" -d '{"name":"Player","stateName":"Idle"}'

Skills Overview

SkillDescription
animator_create_controllerCreate new Animator Controller
animator_add_parameterAdd parameter to controller
animator_get_parametersList all parameters
animator_set_parameterSet parameter value at runtime
animator_playPlay animation state
animator_get_infoGet Animator component info
animator_assign_controllerAssign controller to GameObject
animator_list_statesList states in controller
animator_add_stateAdd a state to a controller layer
animator_add_transitionAdd a transition between two states

Parameter Types

TypeDescriptionExample Use
floatDecimal valueSpeed, blend weights
intInteger valueState index
boolTrue/falseIsGrounded, IsRunning
triggerOne-shot signalJump, Attack

Skills

animator_create_controller

Create a new Animator Controller.

ParameterTypeRequiredDefaultDescription
namestringYes-Controller name
folderstringNo"Assets/Animations"Save folder

Returns: {success, name, path}

animator_add_parameter

Add a parameter to a controller.

ParameterTypeRequiredDefaultDescription
controllerPathstringYes-Controller asset path
paramNamestringYes-Parameter name
paramTypestringNofloatfloat/int/bool/trigger
defaultFloatfloatNo0Initial float value
defaultIntintNo0Initial int value
defaultBoolboolNofalseInitial bool value

animator_get_parameters

Get all parameters from a controller.

ParameterTypeRequiredDescription
controllerPathstringYesController asset path

Returns: {controller, parameters: [{name, type, defaultFloat, defaultInt, defaultBool}]}

animator_set_parameter

Set a parameter value at runtime (supports name/entityId/instanceId/path).

ParameterTypeRequiredDescription
namestringNo*GameObject name
entityIdstringNo*GameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo*GameObject instance ID
pathstringNo*GameObject hierarchy path
paramNamestringYesParameter name
paramTypestringNofloat/int/bool/trigger (default: float)
floatValuefloatNo*Float value
intValueintNo*Integer value
boolValueboolNo*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/entityId/instanceId/path).

ParameterTypeRequiredDefaultDescription
namestringNo*-GameObject name
entityIdstringNo*nullGameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo*0GameObject instance ID
pathstringNo*nullGameObject hierarchy path
stateNamestringYes-Animation state name
layerintNo0Animator layer
normalizedTimefloatNo0Start time (0-1)

*At least one identifier required.

animator_get_info

Get Animator component information (supports name/entityId/instanceId/path).

ParameterTypeRequiredDefaultDescription
namestringNonullGameObject name
entityIdstringNonullGameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo0GameObject instance ID
pathstringNonullGameObject hierarchy path

Returns: {gameObject, instanceId, hasController, controllerPath, speed, applyRootMotion, updateMode, cullingMode, layerCount, parameterCount}

animator_assign_controller

Assign a controller to a GameObject (supports name/entityId/instanceId/path).

ParameterTypeRequiredDescription
namestringNo*GameObject name
entityIdstringNo*GameObject entity ID (preferred; the only id on Unity 6000.4+)
instanceIdintNo*GameObject instance ID
pathstringNo*GameObject hierarchy path
controllerPathstringYesController asset path

*At least one identifier required.

animator_list_states

List all states in a controller layer.

ParameterTypeRequiredDefaultDescription
controllerPathstringYes-Controller asset path
layerintNo0Layer index

Returns: {controller, layer, layerName, stateCount, states: [{name, tag, speed, hasMotion}]}

animator_add_state

Add a state to an Animator Controller layer.

ParameterTypeRequiredDefaultDescription
controllerPathstringYes-Controller asset path
stateNamestringYes-Name for the new state
clipPathstringNonullAnimation clip asset path to assign; a path that is not an AnimationClip rejects the call before the state is added
layerintNo0Layer index

Returns: {success, controller, stateName, layer}

animator_add_transition

Add a transition between two states in an Animator Controller.

ParameterTypeRequiredDefaultDescription
controllerPathstringYes-Controller asset path
fromStatestringYes-Source state name
toStatestringYes-Destination state name
layerintNo0Layer index
hasExitTimeboolNotrueWhether transition waits for exit time
durationfloatNo0.25Transition duration in seconds

Returns: {success, from, to, layer, hasExitTime, duration}


Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-animator">View unity-animator on skillZs</a>