Agent skill

Openhue

by taracodlabs in taracodlabs/aiden

Control Philips Hue lights via OpenHue CLI + Hue Bridge API. An agent skill from taracodlabs/aiden.

Apache-2.0Auto-check passedBackend & APIs

Install Openhue

skills CLI
$ npx skills add taracodlabs/aiden --skill openhue -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install taracodlabs/aiden openhue --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openhue .claude/skills/openhue && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openhue
GitHub stars
851
Token cost
~876 tokens
SKILL.md length
249 words
Files
2
Skills in repo
63
Repo updated
First seen
Licence
Apache-2.0

At a glance

Control Philips Hue lights via OpenHue CLI + Hue Bridge API. An agent skill from taracodlabs/aiden.

  • Works in 7 steps: Install OpenHue CLI → First-time setup — discover and pair… → List all lights → …
  • Backend & APIs work in your project
  • SKILL.md covers When to Use, How to Use, Examples and Cautions
  • Calls winget and npm; needs HUE_API_KEY

What it does

Openhue is an agent skill from taracodlabs/aiden. Control Philips Hue lights via OpenHue CLI + Hue Bridge API

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

It sits in Backend & APIs. The repository describes itself as: Aiden — an autonomous AI agent and work engine built solo. It can operate your browser, terminal, files, apps, APIs, skills and tools, remember context, recover from failures… The licence is Apache-2.0.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/openhue”

Requirements

  • Node.js
  • A credential in YOUR_API_KEY
  • A credential in HUE_API_KEY

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Install OpenHue CLI
  2. First-time setup — discover and pair with Bridge
  3. List all lights
  4. Turn lights on and off
  5. Change brightness and color
  6. Activate a scene
  7. Use the Hue local REST API directly

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • winget
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • HUE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openhue loads about 876 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 249 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~876

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 249 words, ~876 tokens.

Download SKILL.mdSave it as .claude/skills/openhue/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
openhue
description
Control Philips Hue lights via OpenHue CLI + Hue Bridge API
category
smart-home
version
1.0.0
origin
aiden
license
Apache-2.0
tags
hue, philips, smart-home, lights, openhue, cli, iot, automation, rgb, brightness

Philips Hue Smart Light Control

Control Philips Hue lights using the OpenHue CLI or the local Hue Bridge REST API. Works entirely on your local network — no cloud required.

When to Use

  • User wants to turn lights on or off
  • User wants to change light color or brightness
  • User wants to activate a Hue scene
  • User wants to list all lights and their current state
  • User wants to set up automation rules for lights

How to Use

1. Install OpenHue CLI
powershell
# Install via winget
winget install openhue.cli

# Or via npm
npm install -g openhue-cli

# Verify
openhue --version
2. First-time setup — discover and pair with Bridge
powershell
# Discover the Hue Bridge on your network
openhue discover

# Pair (press the button on the Bridge within 30 seconds, then run)
openhue pair --host 192.168.1.x   # use IP from discover output

# Save credentials
openhue configure --host 192.168.1.x --api-key YOUR_API_KEY
3. List all lights
powershell
openhue get lights
4. Turn lights on and off
powershell
# Turn specific light on/off (by ID or name)
openhue set light "Living Room 1" --on true
openhue set light "Living Room 1" --on false

# Turn all lights off
openhue set lights --on false
5. Change brightness and color
powershell
# Brightness 0-100
openhue set light "Desk Lamp" --brightness 70

# Set color by hue/saturation (hue 0-360, saturation 0-100)
openhue set light "Desk Lamp" --hue 240 --saturation 80 --brightness 80

# Set color temperature in Kelvin (2000K warm to 6500K cool)
openhue set light "Desk Lamp" --color-temp 3000
6. Activate a scene
powershell
# List available scenes
openhue get scenes

# Activate a scene in a room
openhue set scene "Relax" --room "Living Room"
7. Use the Hue local REST API directly
powershell
$bridge  = "192.168.1.x"
$apiKey  = $env:HUE_API_KEY
$baseUrl = "https://$bridge/clip/v2"
$headers = @{ "hue-application-key" = $apiKey }

# List all lights
$lights = (Invoke-RestMethod -Uri "$baseUrl/resource/light" -Headers $headers -SkipCertificateCheck).data
$lights | Select-Object id, @{N="name";E={$_.metadata.name}}, @{N="on";E={$_.on.on}}

# Turn a specific light on
$lightId = $lights[0].id
$body    = @{ on = @{ on = $true } } | ConvertTo-Json
Invoke-RestMethod -Uri "$baseUrl/resource/light/$lightId" -Method Put -Headers $headers -Body $body -SkipCertificateCheck

Examples

"Turn off all the lights in the bedroom" → Use step 4: openhue set lights --room "Bedroom" --on false

"Set my desk lamp to a cool blue for focus mode" → Use step 5: --hue 220 --saturation 90 --brightness 75 for a cool blue light.

"Activate the Movie scene in the living room" → Use step 6: openhue set scene "Movie" --room "Living Room".

Cautions

  • The Hue Bridge must be on the same local network as the machine running Aiden
  • -SkipCertificateCheck is needed for direct API calls — the Bridge uses a self-signed certificate
  • OpenHue CLI stores credentials in ~/.openhue/ — do not share this directory
  • Hue API v2 uses UUIDs for light IDs — use the list command to find IDs before automating
  • Color temperature range varies by bulb model — not all bulbs support full 2000K-6500K range

© taracodlabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/openhue of taracodlabs/aiden.

  • SKILL.md
  • skill.json

Open the folder on GitHubat commit 3704204

Compare with similar skills

Openhue next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openhue compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openhue this skilltaracodlabs/aiden851—~876Automated safety check: PassApache-2.0
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api44k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    44k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from taracodlabs/aiden

All 63 skills in this repo
  • Google Flights Search

    taracodlabs/aiden

    Searches Google Flights for prices, schedules and availability through browser automation with URL-based queries, and stops short of booking.

    851 GitHub stars~1.5k tokensUpdated 26 days ago
    Auto-check passed
  • OpenAI Codex CLI Bridge

    taracodlabs/aiden

    Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.

    851 GitHub starsUsed in 1 repo~826 tokens
    Auto-check passed
  • Google Hotels Search

    taracodlabs/aiden

    Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table.

    851 GitHub stars~1.5k tokensUpdated 26 days ago
    Auto-check passed
  • Generates dark-themed architecture, component, data-flow and network diagrams as self-contained HTML and SVG files that open in any browser.

    851 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Aggregates holdings across Zerodha, Upstox and Angel One and normalizes order parameters into one format, with confirmation required before any routing.

    851 GitHub stars~1.1k tokensUpdated 26 days ago
    Auto-check passed
  • arXiv Paper Search

    taracodlabs/aiden

    Searches arXiv by keyword, category, author or paper ID through its public API and downloads PDFs, with no API key needed.

    851 GitHub stars~1k tokensUpdated 26 days ago
    Auto-check passed

Categories

Questions about Openhue

What does Openhue do?

Control Philips Hue lights via OpenHue CLI + Hue Bridge API. An agent skill from taracodlabs/aiden. Openhue is an agent skill from taracodlabs/aiden.

When should I use Openhue?

Openhue fits situations like: backend & APIs work in your project.

How do I install Openhue in Claude Code?

Run `npx skills add taracodlabs/aiden --skill openhue -a claude-code`. Or copy the skill folder (skills/openhue in taracodlabs/aiden) into .claude/skills/openhue in your project. Claude Code loads it when a task matches its description.

How do I install Openhue in Codex?

Run `npx skills add taracodlabs/aiden --skill openhue -a codex`. Or copy the skill folder (skills/openhue in taracodlabs/aiden) into .agents/skills/openhue in your project. Codex loads it when a task matches its description.

Can I use Openhue in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill openhue -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openhue, .gemini/skills/openhue, .github/skills/openhue and .opencode/skills/openhue in your project.

What does Openhue need to run?

Going by SKILL.md and its folder, Openhue needs the command-line tools its instructions call (winget and npm) and credentials named HUE_API_KEY. Our summary lists: Node.js; A credential in YOUR_API_KEY; A credential in HUE_API_KEY.

Does Openhue access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Openhue safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Openhue use?

Openhue is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openhue use?

About 876 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Openhue?

Skills that share tags, products or a category with Openhue: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 44k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openhue?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 851 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.