home / skills / wedsamuel1230 / arduino-skills / arduino-project-builder

arduino-project-builder skill

safe

This skill generates complete, production-ready Arduino projects across environmental monitors, robots, and IoT devices, integrating sensors, actuators,

npx playbooks add skill wedsamuel1230/arduino-skills --skill arduino-project-builder

Review the files below or copy the command above to add this skill to your agents.

Files (19)

SKILL.md

3.8 KB

---
name: arduino-project-builder
description: Build complete, production-ready Arduino projects (environmental monitors, robot controllers, IoT devices, automation systems). Assembles multi-component systems combining sensors, actuators, communication protocols, state machines, data logging, and power management. Supports Arduino UNO, ESP32, and Raspberry Pi Pico with board-specific optimizations. Use this skill when users request complete Arduino applications, not just code snippets.
---

# Arduino Project Builder

Assemble complete, working Arduino projects from requirements. This skill combines multiple patterns (sensors, actuators, state machines, logging, communication) into cohesive systems.

## Quick Start

**List available project types:**
```bash
uv run --no-project scripts/scaffold_project.py --list
```

**Create a complete project:**
```bash
uv run --no-project scripts/scaffold_project.py --type environmental --board esp32 --name "WeatherStation"
uv run --no-project scripts/scaffold_project.py --type robot --board uno --output ./my-robot
```

**Interactive mode:**
```bash
uv run --no-project scripts/scaffold_project.py --interactive
```

## Resources

- **examples/** - Complete project examples (environmental monitor, robot controller, IoT device)
- **scripts/scaffold_project.py** - CLI tool for project scaffolding (config.h, main.ino, platformio.ini, README)
- **assets/workflow.mmd** - Mermaid diagram of project assembly workflow

## Supported Project Types

### Environmental Monitors
Multi-sensor data loggers (temperature, humidity, light, air quality)

See [Environmental Monitor Example](examples/project-environmental-monitor.md)

### Robot Controllers
Motor control, sensor fusion, obstacle avoidance, state machines

See [Robot Controller Example](examples/project-robot-controller.md)

### IoT Devices
WiFi/MQTT data transmission, cloud integration, remote monitoring

See [IoT Device Example](examples/project-iot-device.md)

### Home Automation
Relay control, scheduled tasks, sensor-triggered actions

### Data Acquisition Systems
High-frequency sampling, SD card logging, real-time visualization

## Project Assembly Workflow

- [ ] **[Requirements Gathering](workflow/step1-requirements-gathering.md)** - Analyze user request and gather project specifications
- [ ] **[Architecture Design](workflow/step2-architecture-design.md)** - Design component connections, data flow, and state machines
- [ ] **[Code Assembly](workflow/step3-code-assembly.md)** - Combine patterns and customize for user hardware
- [ ] **[Testing & Validation](workflow/step4-testing-validation.md)** - Verify compilation, memory usage, and functionality
- [ ] **[Documentation](workflow/step5-documentation.md)** - Create wiring diagrams, usage instructions, and troubleshooting guides

## Quality Standards & Rules

- [ ] **[Quality Standards](rules/quality-standards.md)** - Hardware abstraction, non-blocking code, error handling, and memory safety requirements
- [ ] **[Integration Checklist](rules/integration-checklist.md)** - Pre-delivery verification for sensor validation, timing, and reliability
- [ ] **[Board Considerations](rules/board-considerations.md)** - UNO, ESP32, and RP2040 specific optimizations and constraints

## Project Output Template

- [ ] **[Output Template](templates/project-output-template.md)** - Standardized format for delivering complete Arduino projects

## Resources

- **examples/** - Complete project examples with full implementations
- **scripts/scaffold_project.py** - CLI tool for project scaffolding with config.h, main.ino, platformio.ini, README
- **assets/workflow.mmd** - Mermaid diagram of project assembly workflow
- **workflow/** - Step-by-step project assembly process
- **rules/** - Quality standards and board-specific optimizations
- **templates/** - Project output templates and documentation standards

Overview

This skill builds complete, production-ready Arduino projects by assembling sensors, actuators, communication stacks, state machines, logging, and power management into cohesive applications. It supports Arduino UNO, ESP32, and Raspberry Pi Pico with board-specific optimizations and templates. Use it when you need a full project scaffolded, not just isolated code snippets. The output includes wiring notes, build configuration, and testing guidance.

How this skill works

Provide project requirements (type of project, target board, sensors/actuators, communication and power constraints) and the tool generates a full project scaffold. It composes reusable patterns—sensor drivers, non-blocking control loops, state machines, data logging, and comms (WiFi/MQTT, serial, SD)—then tailors code and configuration for the chosen board. The workflow includes requirements gathering, architecture design, code assembly, testing validation, and documentation for wiring and deployment. A CLI script can run in interactive mode or accept flags to produce a ready-to-build project directory.

When to use it

You need a complete deployable Arduino/embedded application rather than a single function or snippet.
You want multi-component systems combining sensors, actuators, logging, and networking.
You need board-specific optimizations for UNO, ESP32, or Raspberry Pi Pico.
You want standardized project structure with build configs and wiring guidance.
You need a reproducible workflow from requirements to testing and documentation.

Best practices

Define clear hardware and functional requirements before scaffolding the project.
Specify power budget and sampling/actuation timing to guide optimizations and watchdog usage.
Prefer non-blocking patterns and hardware abstraction layers for portability across boards.
Include tests for compilation, memory footprint, and core functionality before deployment.
Document wiring, calibration steps, and failure modes in the generated project deliverables.

Example use cases

Environmental monitor: multi-sensor logger sampling temp, humidity, light, and air quality with SD logging or MQTT uplink on ESP32.
Robot controller: motor drivers, obstacle sensors, state machine behaviors, and safety interlocks for an Arduino UNO based rover.
IoT device: WiFi-enabled ESP32 device sending sensor telemetry to MQTT/cloud with OTA and power management.
Home automation: relay control with scheduled tasks, sensor triggers, and remote status over serial or network.
Data acquisition: high-frequency sampling with SD card logging and realtime serial visualization on RP2040.

FAQ

Which boards are supported?

Supported boards include Arduino UNO, ESP32, and Raspberry Pi Pico (RP2040) with tailored templates and optimizations.

Can I customize the generated code?

Yes. The scaffold produces modular code and configuration files so you can replace drivers, tune timings, or add features before building.

Does it include testing and validation steps?

Yes. The workflow includes compilation checks, memory usage warnings, functional test suggestions, and documentation for wiring and calibration.