---
name: scene
description: Activate predefined lighting scene presets (reading, focus, relax, movie, night, energize) when the user asks for activity-based or environment lighting. Scenes control both color temperature AND brightness. Do NOT use for specific colors (use LED Control) or emotion expression (use Emotion).
---

# Lighting Scenes

## Quick Start
Activate predefined lighting presets that set optimal color temperature and brightness for specific activities. Use this for ALL activity-based or environment lighting requests.

## Workflow
1. Determine which scene matches the user's request or activity
2. Prefix reply with `[HW:/scene:{"scene":"name"}]` — the device fires it before TTS
3. Confirm the scene activation to the user
4. Optionally chain emotion: `[HW:/scene:{"scene":"night"}][HW:/emotion:{"emotion":"sleepy","intensity":0.7}]`

## Examples

Input: "Reading mode"
Output: `[HW:/scene:{"scene":"reading"}]` Reading mode activated — 80% brightness, neutral white.

Input: "Goodnight" / "good night" / "time to sleep"
Output: `[HW:/scene:{"scene":"night"}][HW:/emotion:{"emotion":"sleepy","intensity":0.7}]` Night mode on. Sweet dreams!

Input: "I want to relax" / "let me chill"
Output: `[HW:/scene:{"scene":"relax"}]` Relax mode — warm, gentle light at 40%.

Input: "Movie time" / "watching a movie"
Output: `[HW:/scene:{"scene":"movie"}]` Movie mode — dim amber bias lighting.

Input: "I need to focus"
Output: `[HW:/scene:{"scene":"focus"}]` Focus mode — full brightness, cool white.

Input: "Make it purple"
Output: Do NOT use this skill. Use **LED Control** skill instead.

Input: Conversational reply needing emotion
Output: Do NOT use this skill for emotion. Use **Emotion** skill instead (you CAN use both Scene + Emotion together).

## How to Activate a Scene

**No exec/curl needed.** Inline marker at start of reply:

```
[HW:/scene:{"scene":"reading"}] Reading mode activated.
[HW:/scene:{"scene":"night"}][HW:/emotion:{"emotion":"sleepy","intensity":0.7}] Night mode on. Sweet dreams!
```

### Available scenes

| Scene | Brightness | Color Temp | Best for |
|---|---|---|---|
| `reading` | 80% | ~4000K neutral white | Reading, studying, desk work |
| `focus` | 100% | ~5000K cool white | Deep work, coding, no distractions |
| `relax` | 40% | ~2700K warm | Winding down, casual chat |
| `movie` | 15% | ~2700K dim amber | Watching videos, bias lighting |
| `night` | 5% | ~2200K very warm | Sleep-friendly, minimal light |
| `energize` | 100% | ~6500K daylight | Morning wake-up, need energy |

## Error Handling
- If the API returns an error or is unreachable, inform the user: "I couldn't change the lighting scene right now. The hardware service may be unavailable."
- If the user requests a scene that does not exist, suggest the closest available scene from the table above.

## Rules
- **Scene = brightness + color.** This is why you must use Scene instead of direct LED for ambiance. LED `/led/solid` is always 100% brightness — useless for sleep/relax.
- **"sleepy", "goodnight", "time to sleep", "going to bed"** -> ALWAYS use `night` (5% brightness, ultra-dim).
- **"relax", "chill", "unwind"** -> use `relax` (40%).
- **"watch a movie", "movie"** -> use `movie` (15%).
- After activating a scene, you can ALSO call Emotion to show your personality — emotion is a brief reaction, scene is the persistent ambient light.
- You can switch scenes smoothly — just call the endpoint, the LED update is immediate.
- **Scene off:** `[HW:/scene/off:{}]` deactivates the current scene and returns to idle state (restores camera, speaker, servo, idle LED). Use when:
  - User says "normal mode" / "turn off scene" / "back to normal"
  - Current scene doesn't match the time of day — switch to appropriate scene OR turn off
  - "Turn off the light" → use LED Control skill (`/led/off`), not Scene
- For custom lighting beyond these presets, use the LED Control skill directly with specific RGB values.
- **Do NOT use for specific color requests** -> use **LED Control** skill.
- **Do NOT use for expressing emotion** -> use **Emotion** skill.

## Output Template
```
[Scene] {scene_name} activated — {brightness}%, {color_temp}
```
Examples:
- `[Scene] reading activated — 80%, 4000K neutral white`
- `[Scene] night activated — 5%, 2200K ultra-warm`
- `[Scene] energize activated — 100%, 6500K daylight`