ESP32 AI Agent Skill

ESP32

A Claude Code plugin for ESP32 embedded systems development. Provides expert-level chip selection, GPIO pin validation with anti-bricking safety checks, code generation for Arduino and ESP-IDF, and comprehensive reference documentation for LVGL and Waveshare hardware.

Installation

Or install from a local clone:

Prerequisites

- Claude Code CLI installed
- Python 3.9+ (for validation and code generation scripts)

Overview

Once installed, Claude automatically activates this plugin when you work on ESP32 projects. It loads hardware reference data on demand and uses validation scripts to prevent common mistakes that can damage hardware.

What it covers:

- Chip selection across 9 ESP32 variants (ESP32, S2, S3, C3, C6, C2, C5, H2, P4)
- GPIO validation that catches strapping pin traps, ADC2/Wi-Fi conflicts, flash pin violations, and input-only pin misuse
- Code generation for Arduino (setup()/loop()) and ESP-IDF (app_main()) with correct bus initialization
- LVGL references for versions 8.2 through 9.5 with API docs, widget catalogs, and migration guides
- Waveshare board references for 60+ dev boards and LCD displays with full pinout tables

Usage

Ask Claude naturally about any ESP32 topic:

Claude will load the relevant reference files, validate your configuration, and generate working code.

Validation Scripts

The plugin includes Python scripts that Claude invokes during its workflow. You can also run them directly:

Input JSON Format

Both scripts accept the same JSON structure:

Supported Variants

Safety Checks

The plugin actively prevents these common hardware mistakes:

Reference Documentation

The plugin includes structured reference docs that Claude loads on demand:

ESP32 Hardware
- Per-variant GPIO pin databases with usability ratings
- Strapping…