Skip to main content
skill CX Codex

arduino-cli-skill — Claude Code skill: what it does, how to install

Guides AI assistants through board discovery, compilation, and sketch flashing via arduino-cli on major operating systems.

MIT 162 installs ★ 33 updated 2026-10-15

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wedsamuel1230/embedded-engineering-skills --skill arduino-cli-skill -a claude-code
Open on GitHub

What arduino-cli-skill does

This skill provides structured terminal workflows for arduino-cli across Linux, macOS, and Windows. It guides the model through finding connected serial ports, managing board cores, compiling sketch files with explicit FQBN strings, and uploading binaries to microcontrollers.

The skill includes references for commands, typical troubleshooting pitfalls, and notes for the Uno R4 family, including Uno R4 Minima and WiFi models. It directs the assistant to favor JSON output whenever command results need automated parsing.

A completed sketch compilation acts only as build proof, while an accepted upload does not verify hardware or power stability. When a setup relies on PlatformIO or vendor utilities, workflows route to those specific tools rather than translating flags silently.

What it helps with

  • detect connected boards and host serial ports
  • compile Arduino sketches for a specific FQBN
  • upload compiled binaries to microcontrollers
  • troubleshoot serial port and upload failures

Example prompts for the agent

  • List all connected Arduino boards and ports using arduino-cli
  • Compile the sketch in path/to/sketch for arduino:avr:uno
  • Help fix a failed upload to an Uno R4 WiFi board

How to install arduino-cli-skill

1Skills CLI (Vercel)

npx skills add wedsamuel1230/embedded-engineering-skills --skill arduino-cli-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/arduino-cli-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/arduino-cli-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about arduino-cli-skill

How to install arduino-cli-skill in Claude Code?

Run npx skills add wedsamuel1230/embedded-engineering-skills --skill arduino-cli-skill -a claude-code in your terminal.

What does arduino-cli-skill do?

It gives coding agents standard command chains and troubleshooting steps for arduino-cli tasks, from library setup to flashing.

Does this skill replace PlatformIO or vendor IDE tools?

No, it explicitly handles the arduino-cli branch and routes PlatformIO or vendor-specific commands to their dedicated workflows.

Source text

SKILL.md · MIT
---
name: arduino-cli-skill
description: Use when users need Arduino CLI commands for board discovery, library installation, compilation, upload, or serial-port troubleshooting on Windows, macOS, or Linux. Use it as the CLI branch of a broader workflow when the project also involves Arduino IDE, PlatformIO, vendor tools, hardware, power, or deployment.
metadata: {triggers: "Arduino CLI, board discovery, compile, upload, serial port"}
---

# Arduino CLI Skill

Provide cross-platform `arduino-cli` workflows and command references.

## Resources

- `references/commands.md` - board, core, library, compile, and upload commands
- `references/serial-ports.md` - OS-specific serial port discovery
- `rules/common-pitfalls.md` - common command mistakes and recovery guidance
- `examples/README.md` - runnable command sequences
- `../../docs/board-support/uno-r4-family.md` - Uno R4 Minima and Uno R4 WiFi support notes

## Workflow

1. Identify the user's platform and target board.
2. Open `references/serial-ports.md` if the task depends on port discovery.
3. Open `references/commands.md` for the exact command family you need.
4. Check `rules/common-pitfalls.md` before suggesting upload or compile fixes.
5. If the target is Uno R4 family and the problem touches WiFi, firmware bridge,
   or OTA-related setup, open `../../docs/board-support/uno-r4-family.md`.
6. Prefer `arduino-cli` JSON output when the result will be parsed or reused.

## Compatibility And Proof Boundary

Record `arduino-cli version`, the core/index version, FQBN, libraries, host OS,
and port before changing commands. Check library architecture support and board
package compatibility. A successful `compile` is build proof only; an accepted
upload is upload proof and does not establish hardware or system success. For
IDE, PlatformIO, or vendor-specific commands, route to the appropriate branch
instead of silently translating them.

## Quick Start

```bash
arduino-cli board list
arduino-cli core list
arduino-cli compile --fqbn arduino:avr:uno path/to/sketch
arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:avr:uno path/to/sketch
```

## Verification

- Confirm the `fqbn` matches the target board.
- Confirm the selected serial port exists before upload.
- Prefer command output over remembered defaults when troubleshooting.

See `references/commands.md` and `references/serial-ports.md` for detailed examples.

## Shared Output Contract

Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.

© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills

Similar skills

All skills for DevOps and infrastructure →

From the same set19

The whole set →
power-budget-calculator power-budget-calculator estimates total power draw and battery lifespan for Arduino, ESP32, and RP2040 boards. Evaluates sleep cycles and recommends battery capacity. CX Codex +1 178installs datasheet-interpreter datasheet-interpreter pulls pinout, I2C address, timing figures and register map out of a component datasheet PDF, so you can wire the module without writing a driver first. CX Codex +1 173installs bom-generator bom-generator builds bills of materials for Arduino, ESP32, and RP2040 projects with parts, quantities, suppliers, price estimates, and compatibility warnings. CX Codex +1 164installs battery-selector battery-selector picks the cell chemistry and charging circuit for an Arduino, ESP32 or RP2040 project, from battery type down to runtime maths. CX Codex +1 163installs code-review-facilitator The code-review-facilitator skill reviews Arduino, ESP32, and RP2040 projects for memory risks, structural issues, and common mistakes. Use it before publishing code or after finishing a feature. CX Codex +1 154installs readme-generator readme-generator generates README.md files for Arduino, ESP32, and RP2040 projects. Use it when a working project needs clear GitHub documentation. CX Codex +1 147installs sensor-calibration-workbench The sensor-calibration-workbench skill guides sensor calibration from warm-up and reference readings to coefficient storage and drift checks for CO2, load-cell, magnetic, color, and analog sensors. CX Codex +1 137installs i2c-bringup-diagnostician i2c-bringup-diagnostician diagnoses I2C bring-up failures on Arduino and ESP32 boards, covering wiring, scanner mismatches, and driver bugs. CX Codex +1 134installs

Project sponsors

Companies that keep this analytics open