Reflectt Skill — Control Physical Spaces

You can control physical space: screens, lights, and audio. Use these tools to create atmosphere, run experiences, and transform rooms.

MCP Server: https://localhost:3333/mcp (Homie)

Quick Start

"Set cozy mood"           → Warm amber lights, 40% brightness
"Run movie night"         → Dims lights, sets bias lighting
"Run Shadow of Malvorth"  → Full dungeon adventure experience
"Show the time on all screens" → Push clock display to all screens

🎭 Light Control

light_mood

Apply a mood preset to all lights.

Moods available:
| Mood | Description |
|------|-------------|
| cozy | Warm amber evening (2200K, 40%) |
| focus | Bright neutral white (5000K, 80%) |
| movie | Dim blue bias lighting (15%) |
| party | Vibrant colors (70%) |
| sleep | Dim red for bedtime (5%) |
| energize | Bright daylight (6500K, 100%) |
| romantic | Warm low pink (20%) |
| safe | Tavern warmth |
| tension | Uneasy blue shadows |
| darkness | Near blackout |
| combat | Danger red alert |
| boss | Epic purple menace |
| treasure | Golden reward |
| victory | Triumphant gold |
| team_canucks | Vancouver blue |
| team_chiefs | Kansas City red |

Parameters:
- mood (required): Mood name
- targets (optional): Specific light entities to affect

light_set

Set a specific light's state.

Parameters:
- entity (required): Light entity ID (e.g., light.living_room)
- state: "on" or "off"
- brightness_pct: 0-100
- color: RGB array [255, 100, 50]
- kelvin: Color temperature 2000-6500
- transition: Seconds for transition

light_effect

Run a dynamic light effect.

Effects:
- pulse — Single bright flash
- breathe — Slow fade in/out
- flicker — Random torch-like
- strobe — Rapid on/off
- alert — Attention flash sequence

Parameters:
- effect (required): Effect name
- targets (optional): Lights to affect
- duration: Seconds (default: 5)
- intensity: 0.0-1.0 (default: 0.7)
- speed: slow, medium, fast
- color: RGB array

light_list

Get all controllable lights from Home Assistant.

mood_list

List all available mood presets.

🖥️ Screen Control

These are existing Homie tools — use them alongside Reflectt.

update_all_screens

Push HTML to all connected screens.

Tips:
- Use data-clock="time" for live clocks
- Make it art, not a dashboard
- Think giant typography (200px+), gradients, vignettes

update_screen

Push HTML to a specific screen.

Parameters:
- screen: Screen ID (e.g., games-room, entry)
- scene.html: Raw HTML content

get_screens

Get status of all connected screens.

🎬 Experiences

Experiences are coordinated multi-device sequences.

experience_run

Run a named experience.

Built-in experiences:
| Experience | Duration | Description |
|------------|----------|-------------|
| shadow-of-malvorth | ~4.5 min | Epic dungeon adventure with narration |
| good-morning | ~1 min | Gentle wake-up with sunrise lighting |
| movie-night | ~15 sec | Cinema ambiance setup |
| wind-down | ~30 sec | Evening transition to restful |
| ambient | instant | Beautiful always-on wallpaper |

Parameters:
- name (required): Experience name
- startFromAct (optional): Resume from specific act

experience_list

List all available experiences.

experience_stop

Stop currently running experience.

experience_status

Check if an experience is running.

sequence_run

Run a custom sequence of steps.

Step types:
- light_mood — Apply mood preset
- light_set — Set light state
- light_effect — Run light effect
- screen_update_all — Push HTML to screens
- speak — Text-to-speech
- play_audio — Play audio file
- wait — Pause for duration

Example:

{
  "steps": [
    { "type": "light_mood", "mood": "movie", "delay_ms": 0 },
    { "type": "speak", "text": "Starting movie night", "delay_ms": 500 },
    { "type": "screen_update_all", "html": "<minimal-clock>", "delay_ms": 0 }
  ]
}

🔊 Audio

speak

Text-to-speech through speakers.

Parameters:
- text (required): Text to speak
- voice (optional): Voice name (Samantha, Alex, Daniel, Karen, Moira)
- screen (optional): Screen to speak through, or "all"

play_audio

Play audio file through screens.

Parameters:
- url (required): Audio URL (HTTPS)
- screen (optional): Target screen or "all"
- volume (optional): 0.0-1.0

Common Patterns

Set the mood

"Set cozy mood"
"Make it movie night lighting"
"Combat mode!" → light_mood: combat

Transform the room

"Run movie night" → experience_run: movie-night
"Wind down for the evening" → experience_run: wind-down

Custom atmosphere

sequence_run with:
- light_mood: romantic
- screen_update_all: <candles visual>
- play_audio: soft jazz

Information displays

"Show the time on all screens"
"Put weather on the entry screen"

Tips

1. Moods over manual — Use light_mood instead of setting individual lights
2. Experiences for sequences — Don't manually orchestrate, use experiences
3. Think atmosphere — Lights + screens + audio together create immersion
4. Art, not dashboards — Screens should be beautiful, not cluttered
5. Timing matters — Use delays in sequences to let effects breathe

Troubleshooting

Lights not responding:
- Check Home Assistant connection
- Use light_list to see available entities
- Ensure entity IDs match HA exactly

Screens not updating:
- Check screen connection with get_screens
- Screens need to be on the same network

Experience not found:
- Use experience_list to see available experiences
- Experience names are case-insensitive, use dashes not spaces

Reflectt Skill Pack v1.0.0 — The skill that lets AI agents mix reality