mqtt-debug

Diagnose MQTT traffic and broker health within AutomationOne's IoT framework.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Auto-one-Family/Automation-One --skill mqtt-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mqtt-debug
Source: https://github.com/Auto-one-Family/Automation-One/tree/main/.claude/skills/mqtt-debug
Command: npx skills add https://github.com/Auto-one-Family/Automation-One --skill mqtt-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams diagnose MQTT traffic, broker health, and message flows within the AutomationOne IoT framework, reducing debugging time and downtime.

Core Features & Use Cases

  • Topic hierarchy mapping for Kaiser ESP and server interactions.
  • Flow diagnostics for heartbeats, commands, config updates, and offline buffering.
  • Reference patterns for error handling, LWT, and retry strategies across ESP32 and the server.

Quick Start

Run a targeted MQTT traffic trace on a Kaiser ESP node to identify data flow bottlenecks and validate topic paths.

Frequently Asked Questions about mqtt-debug

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

FAQPage Schema
How do I debug MQTT message flows and broker health in an IoT edge network?

Debug MQTT message flows by tracing broker traffic and mapping topic hierarchies for ESP and server interactions. This identifies data flow bottlenecks, validates topic paths, and diagnoses heartbeat or command issues within IoT framework components.

What is the best way to trace MQTT command and heartbeat flows across ESP32 nodes?

Trace MQTT command and heartbeat flows by running a targeted traffic trace on Kaiser ESP nodes. This maps topic hierarchies and validates data paths to identify flow bottlenecks and verify message delivery across ESP32 and server interactions.

How do I diagnose MQTT offline buffer overflows and LWT handling issues?

Diagnose MQTT offline buffers and LWT handling by applying reference patterns for error handling and retry strategies. This validates Last Will and Testament configurations and ensures reliable message buffering across ESP32 and server components.

Can I use this to clean up MQTT topic hierarchies and validate topic hygiene?

Yes, you can clean up MQTT topic hierarchies by applying structured guidance with defined topic mappings. This enforces topic hygiene by validating paths and diagnosing cross-ESP server interactions within the AutomationOne IoT framework.

Why are my MQTT config updates not reaching the server from ESP32 edge devices?

MQTT config updates fail when topic paths are invalid or data flow bottlenecks exist. Run targeted traffic traces on Kaiser ESP nodes to validate topic mappings, diagnose offline buffering, and identify disruptions in cross-ESP server interactions.