This handles the full spectrum of ESP32 firmware debugging, from compilation errors to runtime panics. It walks you through Guru Meditation errors with a lookup table for common causes like StoreProhibited and stack overflows, explains how to interpret crash dumps, and covers I2C/SPI/UART communication failures with specific checklists. The skill includes ready-to-run commands for capturing build errors and monitoring serial output, plus practical fixes like adjusting task stack sizes and enabling heap poisoning configs. It's clearly written by someone who's spent time tracking down pointer bugs and I2C address mismatches at 2am. If you're building on ESP-IDF and something crashes, panics, or refuses to compile, start here.

skills.sh installs
313
GitHub stars
7
last updated
Aug 21, 2026

Install

$ npx -y skills add laurigates/mcu-tinkering-lab --skill esp32-debugging --agent claude-code

Installs into .claude/skills of the current project.

Files

ESP32 Firmware Debugging Guide

When to Use This Skill

Apply this skill when the user:

  • Encounters compilation errors in ESP-IDF projects
  • Sees runtime panics or "Guru Meditation Error" messages
  • Has memory-related crashes or stack overflows
  • Experiences I2C/SPI/UART communication failures
  • Needs help interpreting serial monitor output

$ARGUMENTS may contain error messages or context about the issue.

Debugging Process

Ask for Context First

If the error isn't clear from $ARGUMENTS, ask the user to provide:

  1. Full error message or panic output
  2. Which project they're building
  3. Recent code changes

Sponsors

Details

Repository
github.com/laurigates/mcu-tinkering-lab
Category
Debugging
First seen
Jun 3, 2026

Recommended

More Debugging
1incept5 avatareve-troubleshootingincept5/eve-skillpacksTroubleshoot common Eve deploy and job failures using CLI-first diagnostics.310skills.sh installs
2incept5 avatareve-deploy-debuggingincept5/eve-skillpacksDeploy and debug Eve-compatible apps via the CLI, with a focus on staging environments.307skills.sh installs
3onewave-ai avatarregex-visual-debuggeronewave-ai/claude-skillsDebug regex patterns with visual breakdowns, plain English explanations, test case generation, and flavor conversion. Use when user needs help with regular expr302skills.sh installs
4patricio0312rev avatarerror-handling-standardizerpatricio0312rev/skillsCreates consistent error handling with custom error classes, HTTP status mapping, structured logging, safe client messages, and error taxonomy. Use when standar266skills.sh installs
5patricio0312rev avatarllm-debuggerpatricio0312rev/skillsDiagnoses LLM output failures including hallucinations, constraint violations, format errors, and reasoning issues. Provides root cause classification, prompt f255skills.sh installs
6charleswiltgen avataraxiom-ios-performancecharleswiltgen/axiomUse when app feels slow, memory grows, battery drains, or diagnosing ANY performance issue. Covers memory leaks, profiling, Instruments workflows, retain cycles214skills.sh installs