esphome-config-helper

Generates, validates, and troubleshoots ESPHome YAML configurations for ESP32 and ESP8266 devices.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/brillianodhiya/VisionScript --skill esphome-config-helper-brillianodhiya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: esphome-config-helper
Source: https://github.com/brillianodhiya/VisionScript/tree/main/.agents/skills/esphome-config-helper
Command: npx skills add https://github.com/brillianodhiya/VisionScript --skill esphome-config-helper-brillianodhiya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires esphome, and includes scripts (resource) and references (resource) components.

What problem does it solve? Writing ESPHome YAML configurations from scratch is error-prone: GPIO pin conflicts, strapping pin mistakes, misspelled platforms, and YAML indentation issues cause compilation failures and boot loops that are tedious to debug. ## Core Features & Use Cases - Ready-to-use templates: Four working configurations (basic device, DHT22 sensor node, 4-channel relay controller, SSD1306 display node) that you customize with your device name, WiFi credentials, and GPIO pins. - GPIO and sensor references: Complete ESP32/ESP8266 pinout guides identifying safe pins versus strapping pins, plus 20 sensor configurations (BME280, DHT22, HC-SR501, BH1750, VL53L0X, and more) with wiring diagrams. - Troubleshooting and validation: An error lookup table covering compilation, runtime, and hardware issues, plus a validation script that runs esphome config and esphome compile before flashing. - Use Case: You want to add a temperature sensor to a new ESP32 board. Copy the sensor-node template, check the GPIO reference to pick a safe pin, customize the device name and secrets, then run the validation script to confirm it compiles before flashing. ## Quick Start Ask the assistant to create an ESPHome configuration for your device type, for example a temperature sensor node on an ESP32, and it will generate a validated YAML config from the templates.

Frequently Asked Questions about esphome-config-helper

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

FAQPage Schema
How do I create an ESPHome configuration for an ESP32 device?▼

Start from the basic-device or sensor-node template, then customize the device name, WiFi credentials via secrets.yaml, and GPIO pins. Validate the result with the validate-config.sh script, which runs esphome config and esphome compile before flashing.

Which GPIO pins are safe to use on ESP32 and ESP8266?▼

On ESP32, safe pins include GPIO4, GPIO13-14, GPIO16-19, GPIO21-23, GPIO25-27, and GPIO32-33. On ESP8266, use GPIO4 (D2), GPIO5 (D1), GPIO12-14. Avoid strapping pins GPIO0, GPIO2, GPIO12, GPIO15 and flash pins GPIO6-11.

Why does my ESPHome config fail with "GPIO already in use"?▼

This error means the same pin is assigned to multiple components, often because a component uses the default I2C pins (GPIO21/GPIO22 on ESP32) that you also assigned elsewhere. List all pin usage and reassign one component to a different safe pin.

How do I fix ESPHome WiFi connection failed errors?▼

Verify the SSID and password in secrets.yaml, ensure you use a 2.4GHz network since ESP32/ESP8266 do not support 5GHz, and check signal strength. Configuring a static IP with manual_ip avoids DHCP-related failures.

What sensors work with ESPHome and how are they wired?▼

The references cover 20 common sensors including DHT22 and BME280 for temperature, HC-SR501 for motion, BH1750 for light, and HC-SR04 for distance. Each entry includes the platform name, wiring diagram, I2C address, and a complete YAML configuration.

When should I not use this ESPHome configuration helper?▼

For ESP32-S3-BOX-3 specific projects involving audio pipelines, display lambdas, or touch interaction, use the dedicated esphome-box3-builder skill instead. Deep automation logic or network issues are better handled by specialized ESPHome agents.