cantpr09ram/arduino
skills/arduino/SKILL.md
This tool allows you to interact with the Arduino CLI to compile sketches, manage libraries/cores, and upload firmware to microcontrollers. It is the definitive tool for Arduino development in a headless or automated environment.
tools
Updated Apr 22, 2026
$ install --global
skillsauthnpx skillsauth add cantpr09ram/agent-staff arduinoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 23, 2026, 12:23 AM199.4s2 files scanned
SKILL.md
- name:
- arduino
- description:
- This tool allows you to interact with the Arduino CLI to compile sketches, manage libraries/cores, and upload firmware to microcontrollers. It is the definitive tool for Arduino development in a headless or automated environment.
Usage Guidelines
0. Strict Execution Contract
- Treat Arduino operations as a deterministic pipeline: discover -> resolve FQBN -> install deps -> compile -> upload.
- For discovery/search commands, always request machine-readable output with
--format json. - Do not guess command results from prose output; extract board names, ports, and FQBN values from JSON fields.
- If the user did not provide a board model, stop at discovery and ask for board identity only when JSON data cannot disambiguate.
1. Core Concept: FQBN
The FQBN (Fully Qualified Board Name) is the primary identifier for any target hardware. You CANNOT compile or upload without it.
- Format:
package:arch:board(e.g.,arduino:avr:uno,esp32:esp32:esp32). - Action: Always determine the FQBN first using
board listorboard listall.
2. Output Parsing
CRITICAL: Whenever performing discovery or search operations (listing boards, searching libraries), you MUST append --format json to the command.
- This allows for deterministic parsing of version numbers, board IDs, and port addresses.
- Do not rely on human-readable text output for decision-making logic.
3. Workflow
The standard lifecycle for an Arduino task is:
- Environment Prep:
core update-index(Run this once per session). - Hardware Discovery:
board list --format jsonto identify the connected port and potential FQBN. - Dependency Management: Check
sketch.yamlor install libs vialib install. - Compilation:
compile --fqbn <FQBN> --export-binaries <SKETCH_PATH>. - Upload:
upload -p <PORT> --fqbn <FQBN> <SKETCH_PATH>.
4. Failure Handling Rules
- If FQBN is unresolved after discovery, run
board listall <term> --format jsonand map to one exact FQBN before compiling. - If a core is missing, install only the required package (
<package:arch>), then retry compile. - If compile fails, rerun once with
--warnings allfor better diagnostics before proposing code changes. - After compile, verify binary artifacts were exported for reproducibility before moving to upload.
Constraints & Opinions
- Always Export Binaries: When compiling, always use
--export-binaries. This copies the.hexor.binartifact to the sketch directory for verification and reuse. - Library Isolation: Prefer local project compilation logic over global library pollution, though CLI defaults to global.
- Port Detection: If
board listreturnsnull/unknown FQBN, infer the board type from the user's prompt (e.g., "I'm using an ESP32") and map it to a concrete FQBN withboard listall <term> --format json.
Common Commands
- Update Core Index:
arduino-cli core update-index - Search for a Board:
arduino-cli board listall <search_term> --format json - Search for a Core Package:
arduino-cli core search <search_term> --format json - Install Board Core:
arduino-cli core install <package:arch> - List Connected Boards (JSON):
arduino-cli board list --format json - Compile:
arduino-cli compile --fqbn <FQBN> --export-binaries --warnings all <SKETCH_PATH> - Upload:
arduino-cli upload -p <PORT> --fqbn <FQBN> <SKETCH_PATH>
Related Skills
cantpr09ram/value
testing
VerifiedTrustedCommunity
Use abstract principles to evaluate design and engineering decisions.
SKILL.mdUpdated Apr 22, 2026
cantpr09ram/uv
development
VerifiedTrustedCommunity
Use `uv` instead of pip/python/venv. Run scripts with `uv run script.py`, add deps with `uv add`, use inline script metadata for standalone scripts.
SKILL.mdUpdated Apr 22, 2026
cantpr09ram/tmux
tools
VerifiedTrustedCommunity
Remote control tmux sessions for interactive CLIs (python, gdb, etc.) by sending keystrokes and scraping pane output.
SKILL.mdUpdated Apr 22, 2026
cantpr09ram/github
tools
VerifiedTrustedCommunity
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
SKILL.mdUpdated Apr 22, 2026