OpenParable
Skip to content
← Back to skills

Fix Board

Apps & Automation
fix-board

Fix Board is an Agent Skill for apps & automation published in the FastLED/FastLED repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Automatically diagnose and fix PlatformIO board upload/monitor issues. Runs three-phase device workflow (Compile, Upload, Monitor) and applies fixes.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/FastLED/FastLED/blob/HEAD/.claude/skills/fix-board/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/fix-board, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Automatically run the three-phase device workflow (Compile, Upload, Monitor), diagnose any failures, and apply fixes.

  1. Compile: Run compilation using uv run ci/debug_attached.py (compile phase only)
  2. Upload: Execute upload with automatic port conflict resolution
  3. Monitor: Attach to serial monitor, capture output for 10 seconds, detect failure keywords
  4. Diagnose: Identify upload failures, compilation errors, runtime crashes, ESP-IDF errors
  5. Fix: Automatically fix code, configuration, or suggest manual hardware fixes
  6. Verify: Re-test after applying fixes (up to 3 attempts)

Using debug_attached.py

uv run ci/debug_attached.py esp32dev --timeout 10 --fail-on PANIC --fail-on "guru meditation"

What Gets Fixed Automatically

  • Upload failures: Port detection, permission issues, bootloader problems
  • Compilation errors: Missing includes, type errors, dependency issues
  • Configuration issues: Wrong board settings, incorrect platformio.ini parameters
  • Runtime crashes: Watchdog resets, brownout detection, stack overflows

What Requires Manual Intervention

  • Hardware issues: Physical wiring problems, power supply issues
  • Driver issues: Missing USB drivers, permission setup
  • Severe code issues: Major architecture problems requiring human decisions