unity-light

Create and configure Unity lights, probe groups, and reflection probes in scenes.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-light-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-light
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/light
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-light-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up and tuning scene lighting in Unity through an AI agent requires knowing exact light APIs and avoiding hallucinated method names; this Skill provides a verified command surface for creating, configuring, and querying lights without manual editor work. ## Core Features & Use Cases - Light Creation & Configuration: Create Directional, Point, Spot, and Area lights with color, intensity, range, spot angle, and shadow settings via light_create and light_set_properties. - Batch Operations: Configure or toggle multiple lights in a single call with light_set_properties_batch and light_set_enabled_batch, reducing API round trips. - Probes & Lightmapping: Add Light Probe Groups with grid layouts, create Reflection Probes, and inspect lightmap baking settings. - Use Case: When building a night scene, batch-dim all torch lights, adjust their color temperature, and add a reflection probe in one workflow instead of editing each light in the Unity Editor. ## Quick Start Ask the agent to create a warm directional light named Sun with soft shadows and intensity 1.2 in the current Unity scene.

Frequently Asked Questions about unity-light

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a light in Unity with a script or agent?

Call light_create with a lightType of Directional, Point, Spot, or Area, plus optional position, color, intensity, range, and shadows parameters. It returns the new light's name, instanceId, and applied settings.

How do I change multiple Unity lights at once?

Use light_set_properties_batch or light_set_enabled_batch with a JSON array of per-item objects. Each item targets a light by name, instanceId, or path, and failures in one item do not stop the others.

Why does light_set_color or light_delete not work in Unity skills?

Those methods do not exist. Use light_set_properties to change color, intensity, range, and shadows together, and call gameobject_delete from the gameobject module to remove a light's GameObject.

Can I set up light probes and reflection probes in Unity scenes?

Yes. light_add_probe_group adds a Light Probe Group with an optional grid layout defined by axis counts and spacing, and light_add_reflection_probe creates a Reflection Probe at a position with configurable box size and resolution.

What shadow values does Unity light configuration accept?

The shadows parameter accepts the Unity enum values None, Hard, and Soft, matched case-insensitively. An unrecognized value rejects the entire call with SEMANTIC_INVALID and returns the valid values list.