embedded-agent-skills

Claude Code Agent Skills for embedded systems development.

gpio-config

An agent skill that handles GPIO pin assignment and configuration for embedded platforms. Given a project description, it:

1. Detects the target platform and variant
2. Looks up device requirements from a 28-device profile database
3. Assigns GPIO pins while avoiding conflicts (flash pins, strapping pins, peripheral groups)
4. Validates the full assignment against electrical and protocol constraints
5. Generates platform-specific config files (config.txt for RPi, sdkconfig comments for ESP32)
6. Generates initialization code in the appropriate framework
7. Provides wiring notes with safety warnings

Supported Platforms

Features

• 28 device profiles covering sensors, displays, communication modules, and motor controllers
• 20 RPi device tree overlay definitions with conflict matrix
• Safety warnings for strapping pins, flash voltage pins (GPIO12/GPIO45), and boot-mode implications
• I2C address collision detection across 13 common address ranges
• Cross-platform support with platform-appropriate pin numbers, function names, and code patterns
• Variant-aware validation — ESP32-S3 allows GPIO6-11 (blocked on base ESP32), different strapping pin sets per variant

Protocols

I2C, SPI, UART, PWM, 1-Wire, ADC, CAN

Installation

git clone https://github.com/your-org/embedded-agent-skills.git
cd embedded-agent-skills

Usage

Example prompts for Claude Code with this skill installed:

"Set up a BME280 temperature sensor and SSD1306 OLED on a Raspberry Pi 4"

"Configure an ESP32-S3 with SPI LoRa, I2C OLED, and UART GPS"

"I want to use GPIO12 as a button on an ESP32 — is that safe?"

The skill will warn that GPIO12 is a strapping pin (MTDI) that sets flash voltage. If pulled HIGH at boot, it selects 1.8V which can damage 3.3V flash chips.

"Add a CAN bus with MCP2515 on SPI0 to my Pi 4 project"

Testing

cd embedded-agent-skills/gpio-config
python3 -m venv .venv
source .venv/bin/activate
pip install pytest
pytest tests/ -v

Expected: 94 tests passed across 5 modules.

Repository Structure

embedded-agent-skills/
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
└── embedded-agent-skills/
    └── gpio-config/
        ├── SKILL.md
        ├── assets/
        ├── references/
        │   ├── common-devices.md
        │   ├── electrical-constraints.md
        │   ├── protocol-quick-ref.md
        │   └── platforms/
        │       ├── esp32-pins.md
        │       ├── esp32-specifics.md
        │       ├── rpi-overlays.md
        │       └── rpi-pins.md
        ├── scripts/
        │   ├── generate_config.py