Agent skill

Raspberry Pi Pico2

by sammcj in sammcj/agentic-coding

A skill your agent uses when developing with Raspberry Pi Pico 2 or the Pi Debug Probe.

Apache-2.0Auto-check: notes

Install Raspberry Pi Pico2

skills CLI
$ npx skills add sammcj/agentic-coding --skill raspberry-pi-pico2 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sammcj/agentic-coding raspberry-pi-pico2 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills/raspberry-pi .claude/skills/raspberry-pi-pico2 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
raspberry-pi-pico2
GitHub stars
162
Token cost
~1.4k tokens
SKILL.md length
681 words
Files
4 (incl. references)
Skills in repo
64
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when developing with Raspberry Pi Pico 2 or the Pi Debug Probe.

  • Works in 12 steps: SDK defaults to Pico 1. You must… → Use the Raspberry Pi fork of OpenOCD.… → Wrong target config = failed connection.… → …
  • Developing with Raspberry Pi Pico 2
  • SKILL.md covers Reference Files, Quick Reference and Gotchas
  • Calls git and brew; reaches github.com

What it does

Raspberry Pi Pico2 is an agent skill from sammcj/agentic-coding. Use when developing with Raspberry Pi Pico 2 or the Pi Debug Probe.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/debug-probe.md`, `references/pico2-hardware.md` and `references/sdk-toolchain.md`).

It works with C++. The repository describes itself as: Agentic Coding Rules, Templates etc... The licence is Apache-2.0.

When your agent uses it

  • Developing with Raspberry Pi Pico 2
  • The Pi Debug Probe

Example prompts

  • “/raspberry-pi-pico2”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Grep, Glob, Agent

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. SDK defaults to Pico 1. You must explicitly pass -DPICO_BOARD=pico2 to target RP2350. Forgetting this builds for RP2040 and the binary…
  2. Use the Raspberry Pi fork of OpenOCD. Upstream OpenOCD (0.12.0) lacks full RP2350 support. Clone from…
  3. Wrong target config = failed connection. Using rp2040.cfg with a Pico 2 silently fails. Always match the target config to the chip.
  4. SWD uses .elf, BOOTSEL uses .uf2. These are different formats for different flashing methods. Do not try to flash a .uf2 via OpenOCD/SWD.
  5. Debug builds required for meaningful debugging. Always pass -DCMAKE_BUILD_TYPE=Debug to cmake. Release builds optimise away variable state…
  6. RISC-V mode has no FPU. The hardware floating-point unit is only available on Cortex-M33. RISC-V mode uses software float, which is…
  7. RISC-V requires a clean build directory. When switching between ARM and RISC-V, delete the build directory and re-run cmake. In-place…
  8. RISC-V debugging requires pre-selection. The RP2350 boots into Cortex-M33 by default. To debug RISC-V: picotool reboot -u -c riscv, then…
  9. Debug Probe does not power the target. The Pico 2 must be powered via its own USB or VSYS. The SWD connector carries no power.
  10. LED pin differs on wireless models. Non-wireless Pico 2 uses GP25 for the onboard LED. Pico 2 W uses WL_GPIO0 through the CYW43439…
  11. Git submodules are required. The pico-sdk needs git submodule update --init to pull tinyusb, cyw43-driver, lwip, btstack, and mbedtls…
  12. OTP is irreversible. Writing OTP bits is permanent. Misconfiguring secure boot (setting SECURE_BOOT_ENABLE without a boot key and with…

What it can do on your machine

Read from SKILL.md and the folder at commit 2f25ced. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Grep
    • Glob
    • Agent

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Raspberry Pi Pico2 loads about 1.4k tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 681 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Grep, Glob, Agent

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sammcj/agentic-coding at commit 2f25ced, republished under its Apache-2.0 licence (© sammcj). 681 words, ~1,425 tokens.

Download SKILL.mdSave it as .claude/skills/raspberry-pi-pico2/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
raspberry-pi-pico2
description
Use when developing with Raspberry Pi Pico 2 or the Pi Debug Probe.
allowed-tools
Bash, Read, Write, Edit, Grep, Glob, Agent
disable-model-invocation
true
argument-hint
Thing you want to do

Raspberry Pi Pico 2 and Debug Probe

This skill covers development with Raspberry Pi Pico 2 (RP2350) boards and the Raspberry Pi Debug Probe. It includes hardware specs, SDK setup, build configuration, debugging workflows, and common pitfalls.

Reference Files

Consult these for detailed technical content. Read only the file relevant to the current task:

  • references/pico2-hardware.md - RP2350 specs, RP2040 vs RP2350 comparison, pin layout, wireless variant, security features, chip variants
  • references/debug-probe.md - Debug Probe hardware, wiring diagrams, OpenOCD setup, GDB workflow, UART serial, RTT, VS Code integration, rescue mode, troubleshooting
  • references/sdk-toolchain.md - pico-sdk setup, CMake configuration, ARM vs RISC-V builds, picotool commands, MicroPython/CircuitPython, project structure

Quick Reference

Board Selection (CMake)
BoardCMake FlagPlatform
Pico 1-DPICO_BOARD=pico (default)rp2040
Pico 1 W-DPICO_BOARD=pico_wrp2040
Pico 2-DPICO_BOARD=pico2rp2350-arm-s
Pico 2 W-DPICO_BOARD=pico2_wrp2350-arm-s
Pico 2 RISC-V-DPICO_BOARD=pico2 -DPICO_PLATFORM=rp2350-riscvrp2350-riscv
Debug Probe Wiring (SWD)
Debug Probe "D" PinWire ColourPico 2 SWD Pad
SCOrangeSWCLK
GNDBlackGND
SDYellowSWDIO
Debug Probe Wiring (UART)
Debug Probe "U" PinWire ColourPico 2 PinGPIO
TXOrangePin 2GP1 (RX)
RXYellowPin 1GP0 (TX)
GNDBlackPin 3GND

Note the crossover: probe TX to Pico RX, probe RX to Pico TX.

OpenOCD Target Configs
TargetConfig File
Pico 1 (RP2040)target/rp2040.cfg
Pico 2 (RP2350)target/rp2350.cfg
Pico 2 RISC-Vtarget/rp2350.cfg with -c "set USE_CORE { rv0 rv1 }"
Rescue (RP2350)target/rp2350.cfg with -c "set RESCUE 1"
Typical Debug Session
bash
# Terminal 1: OpenOCD
openocd -f interface/cmsis-dap.cfg -f target/rp2350.cfg -c "adapter speed 5000"

# Terminal 2: GDB
arm-none-eabi-gdb my_app.elf
(gdb) target remote localhost:3333
(gdb) monitor reset init
(gdb) load
(gdb) break main
(gdb) continue
Flash via SWD
bash
openocd -f interface/cmsis-dap.cfg -f target/rp2350.cfg \
  -c "adapter speed 5000" \
  -c "program my_app.elf verify reset exit"

Use the .elf file for SWD flashing, not .uf2.

Gotchas

These are the most common mistakes and non-obvious behaviours. Pay close attention.

  1. SDK defaults to Pico 1. You must explicitly pass -DPICO_BOARD=pico2 to target RP2350. Forgetting this builds for RP2040 and the binary will not run on a Pico 2.

  2. Use the Raspberry Pi fork of OpenOCD. Upstream OpenOCD (0.12.0) lacks full RP2350 support. Clone from https://github.com/raspberrypi/openocd.git branch rpi-common.

  3. Wrong target config = failed connection. Using rp2040.cfg with a Pico 2 silently fails. Always match the target config to the chip.

  4. SWD uses .elf, BOOTSEL uses .uf2. These are different formats for different flashing methods. Do not try to flash a .uf2 via OpenOCD/SWD.

  5. Debug builds required for meaningful debugging. Always pass -DCMAKE_BUILD_TYPE=Debug to cmake. Release builds optimise away variable state and reorder code, making breakpoints unreliable.

  6. RISC-V mode has no FPU. The hardware floating-point unit is only available on Cortex-M33. RISC-V mode uses software float, which is significantly slower for float-heavy code.

  7. RISC-V requires a clean build directory. When switching between ARM and RISC-V, delete the build directory and re-run cmake. In-place switching does not work.

  8. RISC-V debugging requires pre-selection. The RP2350 boots into Cortex-M33 by default. To debug RISC-V: picotool reboot -u -c riscv, then use OpenOCD with set USE_CORE { rv0 rv1 }.

  9. Debug Probe does not power the target. The Pico 2 must be powered via its own USB or VSYS. The SWD connector carries no power.

  10. LED pin differs on wireless models. Non-wireless Pico 2 uses GP25 for the onboard LED. Pico 2 W uses WL_GPIO0 through the CYW43439 wireless chip. Code must be conditional.

  11. Git submodules are required. The pico-sdk needs git submodule update --init to pull tinyusb, cyw43-driver, lwip, btstack, and mbedtls. Missing submodules cause cryptic build failures.

  12. OTP is irreversible. Writing OTP bits is permanent. Misconfiguring secure boot (setting SECURE_BOOT_ENABLE without a boot key and with PICOBOOT disabled) permanently bricks the device.

  13. Wireless SPI pin sharing. On Pico 2 W, the VSYS ADC reading and CYW43439 IRQ checking are blocked during SPI transactions to the wireless chip.

  14. Connect GND first. When the Pico 2 is powered from a separate source, connect GND between the target and Debug Probe before any signal lines. Voltage differences can damage the probe.

  15. macOS: OpenOCD needs hidapi and libusb. Install via brew install hidapi libusb. If OpenOCD cannot find the probe, check no other process (VS Code, another OpenOCD instance) holds the USB device.

  16. Multiple debug probes. If multiple CMSIS-DAP devices are connected, specify the serial number: adapter serial <serial_number> in your OpenOCD config.

© sammcj, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in Skills/raspberry-pi of sammcj/agentic-coding.

  • SKILL.md
  • references/debug-probe.md
  • references/pico2-hardware.md
  • references/sdk-toolchain.md

Open the folder on GitHubat commit 2f25ced

Compare with similar skills

Raspberry Pi Pico2 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Raspberry Pi Pico2 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Raspberry Pi Pico2 this skillsammcj/agentic-coding162—~1.4kAutomated safety check: NotesApache-2.0
Paddle BuildPaddlePaddle/Paddle24k—~1kAutomated safety check: PassApache-2.0
Fory Releaseapache/fory4.6k—~2.9kAutomated safety check: PassApache-2.0
ONNX Runtime Shape Inference Safety Auditmicrosoft/onnxruntime22k—~3.3kAutomated safety check: PassMIT
Code Audit3stoneBrother/code-audit8921 repos~2.7kAutomated safety check: PassNone
Qt C++ Code Reviewx-tools-author/x-tools1.1k2 repos~4.3kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Paddle Build

    PaddlePaddle/Paddle

    A skill your agent uses when needing to compile, rebuild, or install Paddle from source after code changes.

    24k GitHub stars~1k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Fory Release

    apache/fory

    Prepare an Apache Fory release candidate from a clean release branch, including the version bump, RC tag, JVM staging, ASF source artifacts, SVN upload, and vote email.

    4.6k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Official

    Finds and fixes out-of-range output writes in ONNX Runtime operator shape-inference functions where a getNumOutputs guard admits too few outputs.

    22k GitHub stars~3.3k tokensUpdated today
    SecurityAuto-check passed
  • Code Audit

    3stoneBrother/code-audit

    Professional code security audit skill covering 55+ vulnerability types.

    892 GitHub starsUsed in 1 repo~2.7k tokens
    SecurityAuto-check passed
  • Qt C++ Code Review

    x-tools-author/x-tools

    Read-only review of Qt6 C++ code that combines a deterministic lint script with six parallel analysis agents and reports only high-confidence issues.

    1.1k GitHub starsUsed in 2 repos~4.3k tokens
    DevelopmentAuto-check passed
  • Leetcuda Cpp Kernel

    xlite-dev/LeetCUDA

    LeetCUDA 中文技术书(584 页,XeLaTeX 源)按需查阅 skill——写、优化、调试或 review CUDA C++/PTX kernel 时的权威参考路由层。当任务涉及:GPU 架构/Roofline/ occupancy、向量化与 coalescing、warp/block reduce、softmax(online/LSE merge)、…

    12k GitHub stars~3.5k tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed

More from sammcj/agentic-coding

All 64 skills in this repo
  • Yue2 Music

    sammcj/agentic-coding

    A skill your agent uses when generating songs with YuE2, covering a recording via SheetSage2 audio-to-ABC, editing a score or lyrics with melody preservation, or building a reproducible listening…

    162 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Bento Slides

    sammcj/agentic-coding

    A skill your agent uses when creating or editing Bento (.bento.html) slide decks, including any request for a single-file HTML slide deck.

    162 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Idrive Backup

    sammcj/agentic-coding

    A skill your agent uses whenever the user wants you to manage, discuss or diagnose iDrive Backup configuration on macOS

    162 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • Piper Tts Training

    sammcj/agentic-coding

    Train custom TTS voices for Piper (ONNX format) using fine-tuning or from-scratch approaches.

    162 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • PPTX To Md

    sammcj/agentic-coding

    Convert a PPTX slide deck into per-slide markdown that preserves both the verbatim text and the meaning of embedded screenshots, diagrams and charts in their original layout positions.

    162 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Skill Creator Primer

    sammcj/agentic-coding

    You MUST load this skill before the skill-creator skill AND before making ANY change to, or conducting a review of ANY Agent Skill.

    162 GitHub stars~9.8k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Raspberry Pi Pico2

What does Raspberry Pi Pico2 do?

A skill your agent uses when developing with Raspberry Pi Pico 2 or the Pi Debug Probe. Raspberry Pi Pico2 is an agent skill from sammcj/agentic-coding. Use when developing with Raspberry Pi Pico 2 or the Pi Debug Probe.

When should I use Raspberry Pi Pico2?

Raspberry Pi Pico2 fits situations like: developing with Raspberry Pi Pico 2; the Pi Debug Probe.

How do I install Raspberry Pi Pico2 in Claude Code?

Run `npx skills add sammcj/agentic-coding --skill raspberry-pi-pico2 -a claude-code`. Or copy the skill folder (Skills/raspberry-pi in sammcj/agentic-coding) into .claude/skills/raspberry-pi-pico2 in your project. Claude Code loads it when a task matches its description.

How do I install Raspberry Pi Pico2 in Codex?

Run `npx skills add sammcj/agentic-coding --skill raspberry-pi-pico2 -a codex`. Or copy the skill folder (Skills/raspberry-pi in sammcj/agentic-coding) into .agents/skills/raspberry-pi-pico2 in your project. Codex loads it when a task matches its description.

Can I use Raspberry Pi Pico2 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sammcj/agentic-coding --skill raspberry-pi-pico2 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/raspberry-pi-pico2, .gemini/skills/raspberry-pi-pico2, .github/skills/raspberry-pi-pico2 and .opencode/skills/raspberry-pi-pico2 in your project.

What does Raspberry Pi Pico2 need to run?

Going by SKILL.md and its folder, Raspberry Pi Pico2 needs the command-line tools its instructions call (git and brew). Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Grep, Glob, Agent.

Does Raspberry Pi Pico2 access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Raspberry Pi Pico2 safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Raspberry Pi Pico2 use?

Raspberry Pi Pico2 is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Raspberry Pi Pico2 use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.3k tokens, read only when the agent opens those files.

What are the alternatives to Raspberry Pi Pico2?

Skills that share tags, products or a category with Raspberry Pi Pico2: Paddle Build (PaddlePaddle/Paddle, 24k stars), Fory Release (apache/fory, 4.6k stars), ONNX Runtime Shape Inference Safety Audit (microsoft/onnxruntime, 22k stars) and Code Audit (3stoneBrother/code-audit, 892 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Raspberry Pi Pico2?

sammcj (a GitHub user) maintains it in sammcj/agentic-coding, which has 162 GitHub stars. The repository holds 64 skills in this directory. The repository was last updated on October 9, 2026.

Source: sammcj/agentic-coding on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.