Files
openclaw/skills/openhue/SKILL.md
Blakeshannon 9cce40d123 feat(skills): Add 'Use when / Don't use when' routing blocks (#14521)
* feat(skills): add 'Use when / Don't use when' blocks to skill descriptions

Based on OpenAI's Shell + Skills + Compaction best practices article.

Key changes:
- Added clear routing logic to skill descriptions
- Added negative examples to prevent misfires
- Added templates/examples to github skill
- Included Blake's specific setup notes for openhue

Skills updated:
- apple-reminders: Clarify vs Clawdbot cron
- github: Clarify vs local git operations
- imsg: Clarify vs other messaging channels
- openhue: Add device inventory, room layout
- tmux: Clarify vs exec tool
- weather: Add location defaults, format codes

Reference: https://developers.openai.com/blog/skills-shell-tips

* fix(skills): restore metadata and generic CLI examples

---------

Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-02-18 01:28:20 +01:00

2.4 KiB

name, description, homepage, metadata
name description homepage metadata
openhue Control Philips Hue lights and scenes via the OpenHue CLI. https://www.openhue.io/cli
openclaw
emoji requires install
💡
bins
openhue
id kind formula bins label
brew brew openhue/cli/openhue-cli
openhue
Install OpenHue CLI (brew)

OpenHue CLI

Use openhue to control Philips Hue lights and scenes via a Hue Bridge.

When to Use

USE this skill when:

  • "Turn on/off the lights"
  • "Dim the living room lights"
  • "Set a scene" or "movie mode"
  • Controlling specific Hue rooms or zones
  • Adjusting brightness, color, or color temperature

When NOT to Use

DON'T use this skill when:

  • Non-Hue smart devices (other brands) → not supported
  • HomeKit scenes or Shortcuts → use Apple's ecosystem
  • TV or entertainment system control
  • Thermostat or HVAC
  • Smart plugs (unless Hue smart plugs)

Common Commands

List Resources

openhue get light       # List all lights
openhue get room        # List all rooms
openhue get scene       # List all scenes

Control Lights

# Turn on/off
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

# Brightness (0-100)
openhue set light "Bedroom Lamp" --on --brightness 50

# Color temperature (warm to cool: 153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# Color (by name or hex)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"

Control Rooms

# Turn off entire room
openhue set room "Bedroom" --off

# Set room brightness
openhue set room "Bedroom" --on --brightness 30

Scenes

# Activate scene
openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

Quick Presets

# Bedtime (dim warm)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# Work mode (bright cool)
openhue set room "Office" --on --brightness 100 --temperature 250

# Movie mode (dim)
openhue set room "Living Room" --on --brightness 10

Notes

  • Bridge must be on local network
  • First run requires button press on Hue bridge to pair
  • Colors only work on color-capable bulbs (not white-only)