How do I install the Wled skill?

Run npx skillmds add modbender/wled in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wled?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wled by modbender — Agent Skill

Name: Wled
Rating: 4.5 (4 reviews)
Author: modbender

Wled

Control WLED LED controllers via HTTP API. Use when a user asks to control WLED lights, LED strips, or ESP-based LED controllers. Supports power on/off, brightness, colors (RGB), effects, palettes, presets, and device status.

modbender eb9ea7c 4 files · 16.9 KB Updated Sep 9, 2026 12 repo stars

File contents

WLED Control

Control WLED LED strips and matrices via the HTTP JSON API.

Requirements

WLED device on the same network
Device IP address or hostname
Python 3 (no external dependencies)

Usage

All commands require --host (or -H) with the WLED device IP/hostname.

Power Control

python3 scripts/wled.py -H <ip> power          # Get power state
python3 scripts/wled.py -H <ip> power on       # Turn on
python3 scripts/wled.py -H <ip> power off      # Turn off

Brightness

python3 scripts/wled.py -H <ip> brightness          # Get current brightness
python3 scripts/wled.py -H <ip> brightness 255      # Max brightness
python3 scripts/wled.py -H <ip> brightness 128      # 50% brightness

Colors

python3 scripts/wled.py -H <ip> color 255 0 0       # Red
python3 scripts/wled.py -H <ip> color 0 255 0       # Green
python3 scripts/wled.py -H <ip> color 0 0 255       # Blue
python3 scripts/wled.py -H <ip> color 255 255 255   # White

Effects

python3 scripts/wled.py -H <ip> effects             # List all effects with IDs
python3 scripts/wled.py -H <ip> effect 0            # Solid color
python3 scripts/wled.py -H <ip> effect 9            # Rainbow
python3 scripts/wled.py -H <ip> effect 9 -s 200     # Rainbow, fast speed
python3 scripts/wled.py -H <ip> effect 9 -i 128     # Rainbow, medium intensity

Palettes

python3 scripts/wled.py -H <ip> palettes            # List all palettes with IDs
python3 scripts/wled.py -H <ip> palette 6           # Set Party palette

Presets

python3 scripts/wled.py -H <ip> presets             # List saved presets
python3 scripts/wled.py -H <ip> preset 1            # Load preset #1

Status

python3 scripts/wled.py -H <ip> status              # Full device status

Reference

See references/api.md for complete API documentation.

Configuration

Avoid passing --host every time by creating a config file at ~/.wled/config.json:

{
  "bedroom": "192.168.1.100",
  "kitchen": "192.168.1.101",
  "living_room": "wled-abc123.local"
}

Then use aliases:

python3 scripts/wled.py -H bedroom brightness 255
python3 scripts/wled.py -H kitchen color 255 0 0

Or set the WLED_HOST environment variable:

export WLED_HOST=192.168.1.100
python3 scripts/wled.py brightness 255

Finding Your WLED Device

WLED devices can typically be found via:

Router admin panel (look for ESP device)
mDNS/Bonjour: wled-<mac>.local
WLED app discovery

Static IP Recommendation

IP addresses change over time. To avoid updating your config, set a static IP on your WLED device:

Option 1: Router-based (easiest)

Open your router admin panel
Find the WLED device by MAC address
Reserve/assign a static IP

Option 2: On-device

Access WLED web UI at http://<current-ip>
Go to Settings → WiFi Settings
Set static IP manually
Save and reboot

Using mDNS hostnames (e.g., wled-abc123.local) also avoids IP tracking—routers resolve these automatically.

---name: wleddescription: Control WLED LED controllers via HTTP API. Use when a user asks to control WLED lights, LED strips, or ESP-based LED controllers. Supports power on/off, brightness, colors (RGB), effects, palettes, presets, and device status.--- # WLED Control Control WLED LED strips and matrices via the HTTP JSON API. ## Requirements - WLED device on the same network - Device IP address or hostname - Python 3 (no external dependencies) ## Usage All commands require `--host` (or `-H`) with the WLED device IP/hostname. ### Power Control ```bash python3 scripts/wled.py -H <ip> power # Get power state python3 scripts/wled.py -H <ip> power on # Turn on python3 scripts/wled.py -H <ip> power off # Turn off ``` ### Brightness ```bash python3 scripts/wled.py -H <ip> brightness # Get current brightness python3 scripts/wled.py -H <ip> brightness 255 # Max brightness python3 scripts/wled.py -H <ip> brightness 128 # 50% brightness ``` ### Colors ```bash python3 scripts/wled.py -H <ip> color 255 0 0 # Red python3 scripts/wled.py -H <ip> color 0 255 0 # Green python3 scripts/wled.py -H <ip> color 0 0 255 # Blue python3 scripts/wled.py -H <ip> color 255 255 255 # White ``` ### Effects ```bash python3 scripts/wled.py -H <ip> effects # List all effects with IDs python3 scripts/wled.py -H <ip> effect 0 # Solid color python3 scripts/wled.py -H <ip> effect 9 # Rainbow python3 scripts/wled.py -H <ip> effect 9 -s 200 # Rainbow, fast speed python3 scripts/wled.py -H <ip> effect 9 -i 128 # Rainbow, medium intensity ``` ### Palettes ```bash python3 scripts/wled.py -H <ip> palettes # List all palettes with IDs python3 scripts/wled.py -H <ip> palette 6 # Set Party palette ``` ### Presets ```bash python3 scripts/wled.py -H <ip> presets # List saved presets python3 scripts/wled.py -H <ip> preset 1 # Load preset #1 ``` ### Status ```bash python3 scripts/wled.py -H <ip> status # Full device status ``` ## Reference See [references/api.md](references/api.md) for complete API documentation. ## Configuration Avoid passing `--host` every time by creating a config file at `~/.wled/config.json`: ```json { "bedroom": "192.168.1.100", "kitchen": "192.168.1.101", "living_room": "wled-abc123.local" } ``` Then use aliases: ```bash python3 scripts/wled.py -H bedroom brightness 255 python3 scripts/wled.py -H kitchen color 255 0 0 ``` Or set the `WLED_HOST` environment variable: ```bash export WLED_HOST=192.168.1.100 python3 scripts/wled.py brightness 255 ``` ## Finding Your WLED Device WLED devices can typically be found via: - Router admin panel (look for ESP device) - mDNS/Bonjour: `wled-<mac>.local` - WLED app discovery ## Static IP Recommendation IP addresses change over time. To avoid updating your config, **set a static IP** on your WLED device: **Option 1: Router-based (easiest)** 1. Open your router admin panel 2. Find the WLED device by MAC address 3. Reserve/assign a static IP **Option 2: On-device** 1. Access WLED web UI at `http://<current-ip>` 2. Go to Settings → WiFi Settings 3. Set static IP manually 4. Save and reboot Using mDNS hostnames (e.g., `wled-abc123.local`) also avoids IP tracking—routers resolve these automatically.

Frequently asked questions