furballroller/super_cat_game/embedded-debug
Claude Code and agent skill by furballroller/super_cat_game
- community
Checking that the SKILL.md file is still in the repository.
Firmware crash analysis, stack trace decoder, and register dump interpreter for ESP32/ARM/AVR platforms. Use when debugging device crashes, panics, guru meditation errors, hard faults, or analyzing core dumps.
Install
npx vskill@latest install furballroller/super_cat_game/embedded-debugSKILL.md
The same SKILL.md was published earlier as gencau/test-practices-agent-configurations/embedded-debug.
Analyze firmware crash output, decode stack traces, and diagnose embedded system failures.
$ARGUMENTS
What This Skill Does
- Crash Analysis: Parse panic handlers, guru meditation errors, hard faults, watchdog resets
- Stack Trace Decoding: Decode raw addresses to function names using ELF binaries
- Register Dump Interpretation: Analyze CPU register state at crash time
- Root Cause Identification: Correlate crash data with source code to find the bug
- Fix Recommendations: Suggest specific code changes to prevent the crash
Supported Platforms
| Platform | Crash Types | |
|---|---|---|
| ESP32 (all variants) | Guru Meditation, LoadProhibited, StoreProhibited, InstrFetchProhibited, watchdog reset, brownout, cache errors | |
| ARM Cortex-M (STM32, Teensy, nRF) | HardFault, MemManage, BusFault, UsageFault, watchdog reset | |
| AVR (Arduino Uno/Mega) | Stack overflow (silent corruption), watchdog reset, undefined opcode | |
| RISC-V (ESP32-C3/C6/H2) | Illegal instruction, load/store fault, breakpoint |
How To Use
With crash output
With a description
With a core dump
What You'll Get
- Decoded stack trace with source file and line numbers
- Explanation of the crash type and what triggered it
- Identification of the faulty code path
- Specific fix recommendations with code examples
- Prevention strategies (stack size tuning, watchdog config, null checks)
ESP32 Crash Quick Reference
Exception Type → Root Cause
| Exception | EXCVADDR hint | Likely Root Cause | |
|---|---|---|---|
LoadProhibited | ~0x00000000 | NULL pointer dereference (uninitialized LED strip?) | |
LoadProhibited | Other | Read from freed or out-of-bounds memory | |
StoreProhibited | Any | Write to read-only or invalid memory address | |
InstrFetchProhibited | Any | Jump to invalid/NULL function pointer or corrupt vtable | |
IllegalInstruction | Any | Stack overflow corrupting code, or corrupt heap | |
IntegerDivideByZero | N/A | Division by zero in LED index math | |
Unaligned | Any | Misaligned memory access (DMA buffer not 4-byte aligned) | |
Cache disabled but cache memory range accessed | Any | ISR accessing flash — add IRAM_ATTR to ISR function |
Key Register Meanings (ESP32 Xtensa)
| Register | Meaning | |
|---|---|---|
PC | Program Counter — where the crash happened | |
EXCVADDR | Address that caused the fault (NULL pointer, invalid write target) | |
A1 | Stack pointer — compare to task stack base to detect overflow | |
A0 | Return address — calling function |
ISR Violation Pattern
Symptoms: Cache disabled but cache memory range accessed or crash inside FreeRTOS API
Cause: FastLED ISR handler calling blocking or flash-accessing code.
Diagnosis: Look for crash inside xSemaphoreTake, vTaskDelay, printf, or any non-ISR-safe function.
Fix:
- Add
IRAM_ATTRto all ISR-related functions - Replace blocking calls with ISR-safe variants (
xSemaphoreGiveFromISR,xQueueSendFromISR) - Move logging out of ISR to a deferred task
Watchdog Reset Pattern
Symptoms: rst:0x7 (TG0WDT_SYS_RESET) or rst:0x8 (TG1WDT_SYS_RESET)
Cause: Task or interrupt handler not yielding — common with:
- FastLED
show()blocking on DMA in a task with watchdog enabled - High LED counts causing long encoding loops without yield
- Spinning in a loop without
vTaskDelay(0)ortaskYIELD()
Fix:
- Call
esp_task_wdt_reset()in long loops, or - Move FastLED
show()to a dedicated task exempt from watchdog, or - Reduce LED count to bring encoding time under watchdog timeout
Stack Overflow Pattern
Symptoms: StackOverflow + task name, or IllegalInstruction with A1 near stack limit
Diagnosis: Check task stack size in xTaskCreate or xTaskCreatePinnedToCore. FastLED show() with large LED arrays can use significant stack.
Fix: Increase task stack size (minimum 4096 bytes for tasks calling FastLED show with encoding)
Memory Corruption Pattern
Symptoms: IllegalInstruction at random address, corrupted register values, intermittent crashes
Diagnosis: Enable diagnostics:
Common FastLED Cause: Writing past end of CRGB array (index out of bounds in user sketch)
Backtrace Decoding Commands
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingsoftware/cat_game/lib/FastLED-master/.claude/skills/embedded-debug/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/furballroller/super_cat_game/embedded-debug)