用途：加速 ESPHome 设备配置的生成与排错，适合新建配置、为现有配置添加传感器/开关/显示屏、排查编译或运行错误、确定安全 GPIO 引脚，以及在烧录前校验配置。ESP32-S3-BOX-3 专用项目应改用 esphome-box3-builder 技能。
主要能力：templates/ 目录提供基础设备、温湿度传感器节点、4 路继电器控制器、OLED 显示节点等模板；references/gpio-pinouts.md 提供 ESP32/ESP8266 安全引脚、strapping 引脚与 I²C/SPI/UART 默认引脚；references/common-sensors.md 汇总常见传感器配置与接线；references/troubleshooting.md 提供编译、运行、配置与硬件错误的排查表；scripts/validate-config.sh 封装校验流程。
使用方式：读取并复制模板后修改设备名、WiFi 凭据与 GPIO 引脚，敏感信息放入 secrets.yaml 并用 !secret 引用。校验命令为 ./.claude/skills/esphome-config-helper/scripts/validate-config.sh my-device.yaml，内部依次执行 esphome config my-device.yaml 与 esphome compile my-device.yaml。运行日志可用 esphome logs device.yaml 查看。
适用场景：常见 ESPHome 设备配置、传感器接入、GPIO 选型、烧录前验证与错误定位。
限制：深度技术问题、复杂自动化、网络问题与 Home Assistant 集成需转交对应 ESPHome 智能体；具体收费、价格与平台支持情况暂未提供。