mcpField
A
arduino-cli-skill

arduino-cli-skill

github.com/wedsamuel1230Development29119 installsUpdated 3w ago
Repository

About arduino-cli-skill

arduino-cli-skill is a skill for developers using `arduino-cli`. It provides cross-platform command workflows and troubleshooting guidance, with checks for board compatibility, serial ports, and what compile or upload results prove.

Key features

  1. 01Guidance for board, core, library, compile, and upload commands
  2. 02OS-specific serial-port discovery guidance
  3. 03Checks board package and library compatibility
  4. 04Separates compile proof from upload proof
  5. 05JSON output guidance for reusable results

Use cases

  1. 01Finding a board and serial port before uploading
  2. 02Compiling a sketch for a specified board
  3. 03Troubleshooting command, compatibility, or upload issues

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wedsamuel1230/arduino-skills --skill arduino-cli-skill

After installing, type/arduino-cli-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

examples/
README.md
references/
commands.md
serial-ports.md
rules/
common-pitfalls.md
scripts/
workflow-windows.ps1

Details

From the project README

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

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: state assumptions, required tools and versions, implementation steps, tests/evidence by proof stage, known limitations, and recovery/security notes.

Comments

Markdown supported