Control Ikea Lightbulb

Control IKEA/TP-Link Kasa smart bulbs (set on/off, brightness, and color). Use when you want to programmatically control a local smart bulb by IP on the LAN.

Security Scan

The skill is internally consistent: it contains LAN-only Python scripts that use python-kasa to control a bulb by IP, and it does not request unrelated credentials or perform suspicious actions.

Purpose & Capability

Name/description match the files and behavior: scripts use python-kasa to contact a device by IP on the LAN and implement on/off, brightness, color, and light-show features. No unrelated services, credentials, or binaries are requested.

Instruction Scope

SKILL.md instructs running local scripts (via uv or wrappers) with a bulb IP. The runtime code only interacts with the provided IP/device and does not read system files, environment secrets, or exfiltrate data to external endpoints.

Install Mechanism

No external download/install spec is included; dependencies are declared in pyproject.toml (python-kasa from PyPI). This is a standard, low-risk approach for a Python LAN device controller.

Credentials

The skill declares no environment variables, credentials, or config paths. The code does not access secrets or unrelated environment entries.

Persistence & Privilege

always is false (normal). The skill can be invoked autonomously by the agent (the platform default) — this is expected for skills but means the agent could call it without additional prompts; there are no other elevated privileges requested.

Assessment

This skill appears to do what it says: control a local Kasa-compatible bulb by IP. Before installing/run it: 1) verify you want the agent to be able to run local scripts (agent-autonomy may allow background invocation); 2) run the code only on a trusted LAN and only against devices you control (it will send commands to any IP you provide); 3) inspect the included Python files yourself (they are present and readable) and install python-kasa from PyPI in an isolated environment (uv/pipx as suggested); 4) if you want to restrict autonomy, disable autonomous invocation for this skill in your agent settings. If you need TRADFRI (IKEA cloud/tradfri protocol) support, request that explicitly — current code targets Kasa-style LAN control.

This skill provides a lightweight Python script to control a local smart bulb (supports TP-Link Kasa-compatible bulbs via python-kasa). It is intended for local LAN devices that do not require cloud credentials; control is by IP address.

When to use this skill

• When you want to turn a bulb on or off
• When you want to set brightness (0-100)
• When you want to set color (HSV)
• When you have the bulb's local IP and it's accessible from this machine

Contents

• scripts/control_kasa_light.py — main runnable script (Python 3.9+)
• scripts/light_show.py — small light-show controller for sequences (uses python-kasa). Changes include:
  • Default white uses a high color temperature (9000K) to make white appear "whiter"; pass --white-temp to override.
  • Bug fixes: the off-flash between blue→red now ignores transitions to white (saturation==0) to avoid white<->blue ping-pong, and white-temp is only applied to white steps (fixes red being skipped during off-flash). White steps also set brightness even without --double-write.
• scripts/run_test_light_show.sh — helper to run light_show via uv

Notes

• This repo is set up for uv (no manual environment activation). Dependencies live in pyproject.toml and wrappers prefer uv run. Example: uv run --project ./skills/control-ikea-lightbulb python ./skills/control-ikea-lightbulb/scripts/control_kasa_light.py --ip 192.168.4.69 --on --hsv 0 100 80 --brightness 80
• Install uv:
  • brew install uv (macOS)
  • pipx install uv (cross-platform)
• The provided wrapper script requires uv: ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --on --hsv 0 100 80 --brightness 80
• The test helper also prefers uv: ./skills/control-ikea-lightbulb/scripts/run_test_light_show.sh --ip 192.168.4.69 --duration 6 --transition 1 --off-flash --verbose
• If your device is actually an IKEA TRADFRI device (not Kasa), this script is a starting point; tell me and I will add TRADFRI support.
• No cloud credentials are required; control happens over LAN to the device's IP.

Quick start

1. Install uv (macOS): brew install uv
2. Turn the bulb on (replace the IP): ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --on
3. Set color and brightness: ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --hsv 0 100 80 --brightness 80

Git note

• No local environment artifacts are tracked; use uv.

Note about Python requirements and recent change

• The skill previously declared python-kasa>=0.13.0 which caused dependency resolution failures on this machine. To make the skill runnable locally the project's pyproject.toml was adjusted to:
  • requires-python = ">=3.11, <4.0"
  • python-kasa>=0.10.2
• This allows the resolver to pick a compatible python-kasa on machines with Python 3.11+. If you prefer a different constraint (or want me to revert this change), tell me and I will update the pyproject.toml and README accordingly.