unity-light
Create and configure Unity lights
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-lightIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The unity-light skill is a legitimate set of instructions for managing Unity lighting components via a local API. It contains no malicious code, external dependencies, or obfuscation, and focuses solely on the intended lighting management functionality.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity Light Skills
Create, configure and inspect lights, probe groups and reflection probes. Parameters come from the schema (GET /skills/schema?category=Light&wire=v2); execution and dryRun rules: root SKILL.md. Per-skill parameter tables: reference/<skill_name>.md.
When to use
- Adding or tuning lights
- Setting up scene lighting, probes or reflection captures
- Batch-enabling or disabling lights
Rules
- Batch first: use the
*_batchskill when operating on 2 or more lights. - Target a light by
entityId(preferred; the only id on Unity 6000.4+),name,instanceId(older Unity) orpath. An id that names nothing is an error, never a fallback to the name. - Query skills (
light_get_info,light_get_properties,light_find_all,light_get_lightmap_settings) areSemiAutoand run in every mode. - The writers (
light_create,light_set_properties*,light_set_enabled*,light_add_probe_group,light_add_reflection_probe) areFullAuto: under Approval they need a grant. - No skill here deletes a light. Use
gameobject_deleteon its GameObject. - Colour channels are 0-1, not 0-255.
Pitfalls
shadowsvalues are the enum membersNone,HardandSoft. Input is case-insensitive, but responses echo the capitalised form, so compare againstSoft.rangeapplies to Point and Spot lights only;spotAngleto Spot only. Other types list them inskipped, not as errors.light_set_properties_batchandlight_set_enabled_batchare all-or-nothing: one bad item rolls back the whole call.
Routing
- Lightmap baking settings →
light_get_lightmap_settings. - Reflection probes →
light_add_reflection_probe; light probe groups →light_add_probe_group.
Light types
| Type | Description | Use case |
|---|---|---|
Directional | Parallel rays, no position | Sun, moon |
Point | Omnidirectional from a point | Torches, bulbs |
Spot | Cone-shaped beam | Flashlights, spotlights |
Area | Rectangle or disc (baked only) | Windows, soft lights |
Skills Overview
| Skill | Batch version | Purpose |
|---|---|---|
light_create | - | Create a light GameObject |
light_set_properties | light_set_properties_batch | Colour, intensity, range, spot angle, shadows |
light_set_enabled | light_set_enabled_batch | Enable or disable a light |
light_get_info | - | Detailed light information |
light_get_properties | - | Alias of light_get_info |
light_find_all | - | List the lights in the open scenes |
light_add_probe_group | - | Light Probe Group, optional grid |
light_add_reflection_probe | - | Reflection Probe at a position |
light_get_lightmap_settings | - | Lightmap baking settings |
DO NOT (common hallucinations):
light_adddoes not exist: uselight_create.light_set_colorandlight_set_intensitydo not exist: uselight_set_properties.light_set_shadowdoes not exist: uselight_set_propertieswithshadows.light_deletedoes not exist: usegameobject_delete.
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-light">View unity-light on skillZs</a>