qol-plugin-lights

Automate Zigbee2MQTT lighting control through a daemon socket and 18-action contract.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/qol-tools/qol-skills --skill qol-plugin-lights
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qol-plugin-lights
Source: https://github.com/qol-tools/qol-skills/tree/main/plugins/qol-plugin-lights/skills/qol-plugin-lights
Command: npx skills add https://github.com/qol-tools/qol-skills --skill qol-plugin-lights

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing qol-tray lights across Zigbee-based backends and ensuring a stable, daemon-driven control surface can be error-prone without a unified contract and auto-config UI.

Core Features & Use Cases

  • Backend adapters orchestration for Zigbee2MQTT and future backends.
  • Daemon-driven action execution via a persistent socket and a stable 18-action contract.
  • Auto-config rendered UI for settings and target/preset configuration.
  • Use Case: Seamless light control in qol-tray across devices with minimal setup.

Quick Start

Configure and start the plugin to begin controlling Zigbee-connected lights through the auto-config UI.

Frequently Asked Questions about qol-plugin-lights

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Zigbee light control through a daemon backend?

Daemon-driven light control works by executing a stable 18-action contract via a persistent IPC socket, allowing you to automate Zigbee lights. It uses modular backend adapters to orchestrate qol-tray devices with minimal setup.

Does this plugin work with Zigbee2MQTT for managing lights?

Yes, it supports Zigbee2MQTT integration through backend adapters. The plugin architecture is modular, meaning it orchestrates Zigbee2MQTT now and is designed to accommodate future backends for seamless light control across your devices.

How do I configure light presets and settings in qol-tray?

You configure light presets and settings through an auto-configured UI rendered by the plugin. Once started, the daemon renders this UI automatically, letting you manage target configurations and settings for your Zigbee-connected lights across Linux and macOS.

Can I use this lighting automation plugin on both Linux and macOS?

Yes, this lighting automation plugin supports both Linux and macOS. It provides an auto-configured UI and daemon socket for IPC, ensuring seamless light control and preset management across both operating systems.

What is the best way to manage multiple Zigbee lights with minimal setup?

The best way to manage multiple Zigbee lights with minimal setup is using a unified plugin contract with an auto-configured UI. This approach renders settings automatically and executes lighting actions through a persistent daemon socket.

Why does my daemon-driven light control setup need a persistent socket?

A persistent daemon socket is needed for reliable IPC between the tray and the backend. It ensures stable execution of the 18-action lighting contract, preventing error-prone disconnections when orchestrating Zigbee2MQTT backends.