Agent skill
fix-board
Automatically diagnose and fix PlatformIO board upload/monitor issues. Runs three-phase device workflow (Compile, Upload, Monitor) and applies fixes.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/fix-board
SKILL.md
Automatically run the three-phase device workflow (Compile, Upload, Monitor), diagnose any failures, and apply fixes.
- Compile: Run compilation using
uv run ci/debug_attached.py(compile phase only) - Upload: Execute upload with automatic port conflict resolution
- Monitor: Attach to serial monitor, capture output for 10 seconds, detect failure keywords
- Diagnose: Identify upload failures, compilation errors, runtime crashes, ESP-IDF errors
- Fix: Automatically fix code, configuration, or suggest manual hardware fixes
- 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?