unity-component
Manage GameObject components
Install / Use
npx skills add Besty0728/Unity-Skills --skill componentInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of unity-component
unity-component scores 83/100 on our quality scale, 915th of 1,155 Content & Media skills we index.
Its SKILL.md is 19 KB long, well organised into 36 sections with 5 code examples: 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-component is actively maintained.
- Our last check on 2026-11-07 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-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-component compared with similar skills
All 4 of these similar skills score higher than unity-component; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-component (this skill)by Besty0728 | 83 | 1.8k | 53d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install unity-component?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-component. The install tabs above show the steps for each supported agent. - Which AI agents does unity-component work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unity-component 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-component still maintained?
- The repository was last updated about 2 months ago, so unity-component is actively maintained.
Skill content
View source on GitHubname: unity-component description: Manage GameObject components
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
- Attaching or removing components
- Copying components between objects
- Toggling components
- Reading/writing serialized fields
- 挂载或移除组件、在对象间复制组件、开关组件、读写序列化字段
Unity Component Skills
BATCH-FIRST: Use
*_batchskills when operating on 2+ objects to reduce API calls from N to 1.
Operating Mode
- Approval:本模块 Mixed ——
component_list/component_get_properties标SkillMode.SemiAuto,可直接执行;写类 skill (component_add/component_set_property/component_set_enabled/component_copy等) 标SkillMode.FullAuto,需 grant 单次执行返结果。 - Auto / Bypass:FullAuto 直接执行。
- 含 NeverInSemi 高危 skill:
component_remove/component_remove_batch(Operation.Delete)。这些在 Approval/Auto 下返MODE_FORBIDDEN,仅 Bypass 或 Allowlist 命中可调。
DO NOT (common hallucinations):
component_create/component_getdo not exist → usecomponent_add(add) andcomponent_get_properties(read)component_finddoes not exist → usecomponent_listto list components on an objectcomponentTypeis case-sensitive —Rigidbodynotrigidbody,BoxCollidernotboxcollider- Custom scripts need exact class name; if namespaced, use
Namespace.ClassName
Routing:
- To create a C# component script → use
scriptmodule'sscript_createfirst, thencomponent_add - To set multiple properties at once → use
component_set_property_batch - To enable/disable a component →
component_set_enabled(notcomponent_set_property)
Object Targeting: All single-object skills accept
name(string),instanceId(int, preferred), andpath(string, hierarchy path). Provide at least one.
Skills Overview
| Single Object | Batch Version | Use Batch When |
|---------------|---------------|----------------|
| component_add | component_add_batch | Adding to 2+ objects |
| component_remove | component_remove_batch | Removing from 2+ objects |
| component_set_property | component_set_property_batch | Setting on 2+ objects |
| component_set_serialized_property | component_set_serialized_property_batch | Setting Inspector SerializedProperty paths |
Other Skills (no batch):
component_list- List all components on an objectcomponent_get_properties- Get component property valuescomponent_set_enabled- Enable/disable a component (Behaviour, Renderer, Collider)component_copy- Copy a component from one object to anothercomponent_get_serialized_properties- List Inspector SerializedProperty pathscomponent_copy_exact- Copy a component and verify serialized fields match
Single-Object Skills
component_add
Add a component to a GameObject.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID (preferred) |
| path | string | No* | Hierarchy path |
| componentType | string | Yes | Component type name |
*At least one identifier required
Returns: {success, gameObject, instanceId, component, fullTypeName} (returns {warning, gameObject, instanceId} instead if a single-instance component already exists)
component_remove
Remove a component from a GameObject.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No* | - | GameObject name |
| instanceId | int | No* | - | Instance ID |
| path | string | No* | - | Hierarchy path |
| componentType | string | Yes | - | Component type to remove |
| componentIndex | int | No | 0 | Index into the components of that type when 2+ exist on the same object |
Returns: {success, gameObject, removed} (removed is the requested componentType string)
component_list
List all components on a GameObject.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID |
Returns: {gameObject, instanceId, path, componentCount, components: [{type, fullType, enabled, keyProperties?}]} (keyProperties only present when includeProperties=true)
component_set_property
Set a component property value.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID |
| path | string | No* | Hierarchy path |
| componentType | string | Yes | Component type |
| propertyName | string | Yes | C# property/field name — see the serialized-name note below |
| value | string | Cond. | New value (basic types, vectors, colors, enums) — wire format below |
| referencePath | string | No | Scene object hierarchy path (for scene references) |
| referenceName | string | No | Scene object name (for scene references) |
| assetPath | string | No | Project asset path (for asset references: Material, Texture, AudioClip, ScriptableObject, Prefab, etc.) |
Which of the four value parameters to use — exactly one carries the payload, and they are checked in this order: assetPath first, then referencePath / referenceName, and value only if neither reference form was supplied. So a value sent alongside an assetPath is silently ignored; never send two.
| Use | When the target field is | Example |
|---|---|---|
| value | a primitive, vector, colour, enum, LayerMask, Rect, Bounds, Quaternion | value="2.5", value="Interpolate" |
| referencePath | a scene object, addressed by hierarchy path (unambiguous) | referencePath="Root/Player/Hand" |
| referenceName | a scene object, addressed by name (first match wins) | referenceName="Player" |
| assetPath | a project asset — Material, Texture, AudioClip, ScriptableObject, Prefab | assetPath="Assets/Materials/Red.mat" |
Wire format of value — multi-component values travel as a comma-separated string: "1,2,3" for a Vector3, "1,0.5,0,1" for an RGBA colour, "0,90,0" for a Quaternion (3 values = Euler, 4 = xyzw). The JSON object form ({"x":1,"y":2,"z":3} / {"r":1,"g":0,"b":0,"a":1}) is accepted only for Vector2/Vector3/Vector4 and Color/Color32, and every component is required: {"y":2} for a Vector3 is rejected naming the missing x, z rather than silently zeroing them. The one optional key is a colour's a, which defaults to 1 — r, g, b are required. An explicit null counts as not supplied, so it fails the same way for a required key. An unrecognised key is rejected with the list of keys that were expected, and a non-numeric value is rejected naming the offending key. Vector2Int/Vector3Int, Quaternion, Rect and Bounds take the comma-separated string only — a JSON object for those fails. Colours additionally accept #RRGGBB / #RRGGBBAA hex and ten names: red, green, blue, white, black, yellow, cyan, magenta, gray/grey, clear. Enums take the member name, case-insensitively. Bools accept true/1/yes/on.
# float / int / bool / string
call_skill("component_set_property", name="Obj", componentType="Rigidbody", propertyName="mass", value=2.5)
call_skill("component_set_property", name="Obj", componentType="Rigidbody", propertyName="useGravity", value=False)
# Vector3
call_skill("component_set_property", name="Obj", componentType="Transform", propertyName="localPosition",
value="1,2,3")
# Color — comma string, hex, or a name
call_skill("component_set_property", name="Obj", componentType="Light", propertyName="color", value="1,0.5,0,1")
call_skill("component_set_property", name="Obj", componentType="Light", propertyName="color", value="#FF8000")
# Enum (member name)
call_skill("component_set_property", name="Obj", componentType="Rigidbody", propertyName="interpolation",
value="Interpolate")
Returns: {success, gameObject, component, property, valueSet, valueType} (valueSet is the string form of the actual value applied; valueType is the resolved target type name)
component_get_properties
Get all properties of a component.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID |
| componentType | string | Yes | Component type |
Returns: {gameObject, component, fullTypeName, properties: [{name, type, fullType, value, canWrite}], fields: [{name, type, fullType, value, isSerializable}]}
component_get_serialized_properties
List Inspector serialized properties on a component via SerializedObject.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID |
| path | string | No* | Hierarchy path |
| componentType | string | Yes | Component type |
| includeChildren | bool | No | Include nested properties |
| limit | int | No | Max properties returned |
Returns: {success, gameObject, component, fullTypeName, properties}
The names here are not the names you write with. This skill reads Unity's serialized backing fields, so a Rigidbody's kinematic flag comes back as
m_IsKinematic, its mass asm_Mass.component_set_property/component_get_propertieswork on the C# API names instead —isKinematic,mass. To convert: drop them_prefix and lowercase the first letter. Feed them_-prefixed path back only tocomponent_set_serialized_property, which expects apropertyPathverbatim. Writingm_IsKinematicthroughcomponent_set_propertyfails with "Property/field not found" (and the error lists the available properties).
component_set_serialized_property
Set an Inspector serialized property by propertyPath.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID |
| path | string | No* | Hierarchy path |
| componentType | string | Yes | Component type |
| propertyPath | string | Yes | SerializedProperty path, e.g. items.Array.data[0] |
| value | string | Cond. | Primitive/vector/color/enum value |
| referenceName | string | No | Scene object name for ObjectReference |
| referenceInstanceId | int | No | Scene object instance ID for ObjectReference |
| referencePath | string | No | Scene object path for ObjectReference |
| assetPath | string | No | Project asset path for ObjectReference |
| objectType | string | No | Expected object/component type for references |
Provide
valuefor scalar properties, or a scene/project reference for ObjectReference fields.
Returns: {success, gameObject, component, propertyPath, valueSet}
Batch Skills
component_add_batch
Add components to multiple objects.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| items | json string | Yes | - | JSON array of per-item objects (see example below) |
Returns: {success, totalItems, successCount, failCount, results: [{success, gameObject, componentType, added}]}
unity_skills.call_skill("component_add_batch", items=[
{"name": "Enemy1", "componentType": "Rigidbody"},
{"name": "Enemy2", "componentType": "Rigidbody"},
{"name": "Enemy3", "componentType": "Rigidbody"}
])
component_remove_batch
Remove components from multiple objects. | Parameter | Type | Required | Default | Description | |---------
Truncated for display — read the full file on GitHub.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
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.
