How do I install the Wled skill?

Run npx skillmds@latest add dvcrn/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. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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.

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

Wled by dvcrn — Agent Skill

Name: Wled
Rating: 4.2 (5 reviews)
Author: dvcrn

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.

dvcrn Updated Sep 8, 2026 32 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 ControlControl 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)## UsageAll commands require `--host` (or `-H`) with the WLED device IP/hostname.### Power Control```bashpython3 scripts/wled.py -H <ip> power # Get power statepython3 scripts/wled.py -H <ip> power on # Turn onpython3 scripts/wled.py -H <ip> power off # Turn off```### Brightness```bashpython3 scripts/wled.py -H <ip> brightness # Get current brightnesspython3 scripts/wled.py -H <ip> brightness 255 # Max brightnesspython3 scripts/wled.py -H <ip> brightness 128 # 50% brightness```### Colors```bashpython3 scripts/wled.py -H <ip> color 255 0 0 # Redpython3 scripts/wled.py -H <ip> color 0 255 0 # Greenpython3 scripts/wled.py -H <ip> color 0 0 255 # Bluepython3 scripts/wled.py -H <ip> color 255 255 255 # White```### Effects```bashpython3 scripts/wled.py -H <ip> effects # List all effects with IDspython3 scripts/wled.py -H <ip> effect 0 # Solid colorpython3 scripts/wled.py -H <ip> effect 9 # Rainbowpython3 scripts/wled.py -H <ip> effect 9 -s 200 # Rainbow, fast speedpython3 scripts/wled.py -H <ip> effect 9 -i 128 # Rainbow, medium intensity```### Palettes```bashpython3 scripts/wled.py -H <ip> palettes # List all palettes with IDspython3 scripts/wled.py -H <ip> palette 6 # Set Party palette```### Presets```bashpython3 scripts/wled.py -H <ip> presets # List saved presetspython3 scripts/wled.py -H <ip> preset 1 # Load preset #1```### Status```bashpython3 scripts/wled.py -H <ip> status # Full device status```## ReferenceSee [references/api.md](references/api.md) for complete API documentation.## ConfigurationAvoid 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:```bashpython3 scripts/wled.py -H bedroom brightness 255python3 scripts/wled.py -H kitchen color 255 0 0```Or set the `WLED_HOST` environment variable:```bashexport WLED_HOST=192.168.1.100python3 scripts/wled.py brightness 255```## Finding Your WLED DeviceWLED devices can typically be found via:- Router admin panel (look for ESP device)- mDNS/Bonjour: `wled-<mac>.local`- WLED app discovery## Static IP RecommendationIP 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 panel2. Find the WLED device by MAC address3. Reserve/assign a static IP**Option 2: On-device**1. Access WLED web UI at `http://<current-ip>`2. Go to Settings → WiFi Settings3. Set static IP manually4. Save and rebootUsing mDNS hostnames (e.g., `wled-abc123.local`) also avoids IP tracking—routers resolve these automatically.

Frequently asked questions