debug-platformio

Automate GDB debugging for PlatformIO projects with environment detection and mode selection.

810|140|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/LeoKemp223/embed-ai-tool --skill debug-platformio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-platformio
Source: https://github.com/LeoKemp223/embed-ai-tool/tree/main/skills/debug-platformio
Command: npx skills add https://github.com/LeoKemp223/embed-ai-tool --skill debug-platformio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, platformio, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the process of GDB debugging for PlatformIO projects, providing a streamlined approach to debugging without the need for manual setup.

Core Features & Use Cases

  • Automated Debugging: Handles the setup and execution of GDB debugging sessions for PlatformIO projects.
  • Environment Detection: Automatically locates the necessary PlatformIO CLI and parses the platformio.ini file.
  • Mode Selection: Offers various debugging modes like download-and-halt, attach-only, and crash-context.
  • Use Case: Ideal for engineers working on embedded systems who need to debug their PlatformIO projects efficiently.

Quick Start

Run the debug-platformio skill with your PlatformIO project directory to start the debugging process.

Frequently Asked Questions about debug-platformio

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GDB debugging for PlatformIO embedded systems projects?

Automating GDB debugging for PlatformIO requires a tool that detects your environment and parses the platformio.ini file. This skill handles setup and execution, streamlining the debugging process without manual configuration.

Do I need Python and PlatformIO installed to use automated GDB debugging?

Yes, Python and PlatformIO must be installed on your system to use automated GDB debugging. The skill relies on the PlatformIO CLI to locate the necessary environment and parse configuration files for your embedded project.

What debugging modes are available for PlatformIO projects using GDB?

Available GDB debugging modes for PlatformIO projects include download-and-halt, attach-only, and crash-context. These modes allow you to either stop execution immediately, attach to a running process, or inspect crash contexts.

What is the best way to start a GDB debugging session in PlatformIO without manual setup?

The best way to start a GDB debugging session without manual setup is to run this skill with your PlatformIO project directory. It automatically configures the environment and initiates the debugger for your embedded systems workflow.

Why does my PlatformIO debugging environment need automatic configuration?

Automatic configuration of your PlatformIO debugging environment is needed to eliminate manual setup errors and streamline the process. The skill automatically locates the CLI and parses configuration files to prepare the GDB session.

Does automated GDB debugging work with any embedded platform in PlatformIO?

Automated GDB debugging works with PlatformIO projects by detecting the necessary debugging environment from your configuration. It supports various debugging modes tailored for engineers working on embedded systems.