skills.rest
szkocot
szkocotCOMMUNITY
Explore all skills by this author →
GitHub

zigbee2mqtt

Configure Zigbee2MQTT files, MQTT topics, and Home Assistant integration.

Updated Jan 28, 2026
Search Tags:#troubleshooting#configuration#mqtt#home-assistant#zigbee#converters
One-click install
npx skills add https://github.com/szkocot/skills --skill zigbee2mqtt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zigbee2mqtt
Source: https://github.com/szkocot/skills/tree/main/zigbee2mqtt
Command: npx skills add https://github.com/szkocot/skills --skill zigbee2mqtt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Zigbee networks often require manual setup and careful integration to connect devices to MQTT ecosystems like Home Assistant. This Skill provides expert guidance to configure Zigbee2MQTT, manage the primary configuration files (configuration.yaml, devices.yaml, groups.yaml), and design robust MQTT topics and device converters for reliable automation.

Core Features & Use Cases

  • Guidance on configuring Zigbee2MQTT, including file layouts, converter mappings, and Home Assistant integration for auto-discovery.
  • Best practices for troubleshooting, debugging, and performance tuning across Zigbee networks.
  • Use Case: Set up a new Zigbee environment with 5 devices and automate them through Home Assistant and Node-RED.

Quick Start

Quick-start steps: Install Zigbee2MQTT, wire up a compatible USB adapter, pair a device, and verify messages on zigbee2mqtt/{device}. Then enable Home Assistant discovery to expose entities automatically.

Frequently Asked Questions about zigbee2mqtt

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

FAQPage Schema
How do I configure Zigbee2MQTT to connect Zigbee devices to Home Assistant?▼

To configure Zigbee2MQTT with Home Assistant, you edit the configuration.yaml file to set MQTT broker credentials and enable Home Assistant discovery. This automatically exposes paired Zigbee devices as entities in Home Assistant.

Why does my Zigbee2MQTT device converter fail to map data correctly?▼

Zigbee2MQTT device converters fail when the device's specific model is unsupported or incorrectly defined in devices.yaml. You must map the Zigbee payload structure to the correct MQTT topic and converter format to resolve data mismatches.

What is the best way to debug Zigbee2MQTT MQTT topic issues?▼

The best way to debug Zigbee2MQTT MQTT topic issues is to verify the message payload on the zigbee2mqtt/{device} topic using an MQTT client. Check configuration.yaml settings and review the Zigbee2MQTT architecture logs for connection errors.

Does Zigbee2MQTT support scalable deployments with multiple Zigbee devices?▼

Zigbee2MQTT supports scalable deployments by managing device definitions in devices.yaml and optimizing network performance. Following best practices for debugging and security ensures reliable automation across large Zigbee networks.

Related Skills

Explore More Software Engineering Skills→
HouseGarofaloHouseGarofalo
3

zigbee2mqtt

Configure and manage Zigbee devices via Zigbee2MQTT for smart home automation.

Official
Intermediate
HouseGarofaloHouseGarofalo
3

node-red-automation

Create flow-based automations with Node-RED for smart home and IoT integrations.

Official
Intermediate
grasberggrasberg
3

iot-engineer

Design and integrate home IoT systems with Home Assistant, MQTT, and Zigbee/Z-Wave.

Community
Advanced
rnavarychrnavarych
14

domain-iot:protocol-advisor

Advise on selecting IoT communication protocols and wireless technologies for deployment scenarios.

Community
Intermediate