unity-cinemachine
Set up Cinemachine Virtual Cameras
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-cinemachineIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a legitimate set of instructions for configuring Unity Cinemachine cameras through a local developer bridge. No malicious patterns, obfuscation, or unauthorized data access attempts were found.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity Cinemachine Skills
Create and tune Cinemachine Virtual Cameras, camera managers, target groups, extensions, impulse and the brain. Parameters come from the schema (GET /skills/schema?category=Cinemachine&wire=v2), which notes the non-obvious ones. Execution, dryRun and verification rules: root SKILL.md.
When to use
- Creating or tuning Cinemachine cameras
- Configuring follow, look-at and noise
- Building cinematic camera behavior
Rules
- Gate:
cinemachine_inspect_vcam,cinemachine_list_componentsandcinemachine_get_brain_infoare read-only and run under Approval. Every other skill isFullAutoand needs a grant. - Delete-class skills are
MODE_FORBIDDENunder Approval and Auto; only Bypass or an Allowlist hit runs them:cinemachine_set_component,cinemachine_target_group_remove_member,cinemachine_remove_extension. The gate is static, from the attribute flags, so it ignores the arguments: everycinemachine_set_componentcall is blocked, includingcomponentType="None"and a switch to another component of the same stage (operating mode). cinemachine_set_componentremoves the stage's current pipeline component before it adds the requested one."None"only removes it, and the same type is a no-op.- Package: needs
com.unity.cinemachine(2.x or 3.x). Without it every skill returnsMISSING_PACKAGE; check with thepackage_*skills first. - 2.x vs 3.x: a reflection adapter (
CinemachineAdapter/CinemachineSkills) bridges both, so skills work on both. CM2 usesCinemachineVirtualCamera, CM3CinemachineCamera; skills handle this. CM3 versions before3.0.0-pre.5changed core camera APIs and may fail from API drift. In compatibility code, usePriority.Valuefor CM3 priority access. - Probe first: run
cinemachine_inspect_vcamto see the fields the installed version exposes before choosingpropertyName;cinemachine_list_componentslists the component names. - VCam targeting:
vcamName,instanceId,pathorentityId(preferred; the only id on Unity 6000.4+), at least one. Skills that address several objects prefix each identifier set (group*,target*,vcam*,spline*,mixer*,child*,camera*,sequencer*,source*). CinemachineBrainis added to the Main Camera on the first VCam creation; there is no add-brain skill.- Higher priority wins activation;
cinemachine_set_activeforces SOLO by setting the highest priority. cinemachine_configure_bodyandcinemachine_configure_aimapply only the fields of the active component and fail withwarningslisting the rest when none matches.- Routing: basic Game Camera operations and the Scene View camera go to the camera module; camera animation sequences go to timeline with a Cinemachine track.
Pitfalls
cinemachine_createdoes not exist: usecinemachine_create_vcamfor virtual cameras.cinemachine_set_target,cinemachine_set_followandcinemachine_set_lookatdo not exist: usecinemachine_set_targets, which sets Follow and LookAt together.cinemachine_add_braindoes not exist.- Do not pick
CinemachineVirtualCameraorCinemachineCameraby version; the skills handle both. SEMANTIC_INVALID(invalidmode, blend style, unresolved animator or bounding shape): fix pervalidValuesor the message; nothing was written.
Skills Overview
- VCam lifecycle and state:
cinemachine_create_vcam,cinemachine_create_freelook,cinemachine_inspect_vcam,cinemachine_list_components,cinemachine_set_active,cinemachine_set_priority,cinemachine_set_targets(Follow and LookAt together). - Properties and pipeline:
cinemachine_set_vcam_property,cinemachine_set_component,cinemachine_add_component(deprecated),cinemachine_set_lens,cinemachine_set_noise,cinemachine_set_spline,cinemachine_configure_body,cinemachine_configure_aim. - Extensions and impulse:
cinemachine_add_extension,cinemachine_remove_extension,cinemachine_configure_extension,cinemachine_impulse_generate,cinemachine_configure_impulse_source. - Brain:
cinemachine_get_brain_info,cinemachine_set_blend,cinemachine_set_brain. - Target groups:
cinemachine_create_target_group,cinemachine_target_group_add_member,cinemachine_target_group_remove_member. - Camera managers:
cinemachine_create_mixing_camera,cinemachine_mixing_camera_set_weight,cinemachine_create_clear_shot,cinemachine_create_state_driven_camera,cinemachine_state_driven_camera_add_instruction,cinemachine_create_sequencer,cinemachine_sequencer_add_instruction,cinemachine_configure_camera_manager.
No batch variants exist in this module. Per-skill tables, item fields and return shapes: reference/<skill_name>.md, rarely needed because the schema notes the parameters.
How can the creator link this skill?
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-cinemachine">View unity-cinemachine on skillZs</a>