mcpField
A
arduino-cli-skill

arduino-cli-skill

github.com/wedsamuel1230Development28128 installsUpdated 2w ago
Repository

About arduino-cli-skill

A skill offering cross-platform workflows and command references for Arduino CLI developers compiling, uploading, or troubleshooting projects. It emphasizes checking board, platform, port, and versions, and distinguishes compile evidence from upload evidence.

Key features

  1. 01References for board and core commands
  2. 02Guidance for serial port discovery
  3. 03Compile and upload workflows
  4. 04Common mistakes and recovery guidance
  5. 05Version checks and proof boundaries

Use cases

  1. 01Compile a project with arduino-cli
  2. 02Find the serial port for an upload
  3. 03Troubleshoot board or library compatibility

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wedsamuel1230/embedded-engineering-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