platformio-mcp: Skill for Claude Code

.skills/esp32-flash-monitor/SKILL.md

esp32-flash-monitor is a skill for Claude Code, Codex from jl-codes/platformio-mcp. It costs 55 tokens per session (546 once invoked), scanned A, original, MIT.

A workflow guide for ESP32-family firmware projects using PlatformIO, a tool for building and uploading embedded code. It covers building, uploading, monitoring, and diagnosing the device.

In plain words
What is it for?
Working with ESP32, ESP8266, ESP32-S3, and ESP32-C3 projects: build the code, upload it after approval, monitor logs, and retry fixes.
Why use it?
It keeps the common build-to-device workflow organised and helps identify crashes or failed startup from serial output.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

This is jl-codes/platformio-mcp's own configuration. It tells Claude Code and Codex how to work on platformio-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything platformio-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to jl-codes/platformio-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/jl-codes/platformio-mcp/main/.skills/esp32-flash-monitor/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/jl-codes/platformio-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for esp32-flash-monitor

README.md
[![agentmods](https://agentmods.dev/badge/skills/jl-codes/platformio-mcp/esp32-flash-monitor/github.svg)](https://agentmods.dev/skills/jl-codes/platformio-mcp/esp32-flash-monitor)
Your own site
<a href="https://agentmods.dev/skills/jl-codes/platformio-mcp/esp32-flash-monitor"><img src="https://agentmods.dev/badge/skills/jl-codes/platformio-mcp/esp32-flash-monitor/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for esp32-flash-monitor

Your own site · 80×15
<a href="https://agentmods.dev/skills/jl-codes/platformio-mcp/esp32-flash-monitor"><img src="https://agentmods.dev/badge/skills/jl-codes/platformio-mcp/esp32-flash-monitor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 546 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.00546
Opus 5.5 $0.00022 $0.00218
Sonnet 5.5 $0.00011 $0.00109
Haiku 4.5 $0.00006 $0.00055

Measured 25d ago against content hash 324dc94f8521, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

esp32-flash-monitor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 25d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.skills/esp32-flash-monitor/SKILL.md · 47 lines

What it actually says

ESP32 Flash and Monitor

Reading results: a non-zero exit means look at BOTH streams. An operation that ran but failed (a build with errors) puts success: false on stdout; one that could not run (bad arguments, policy, a busy port) puts errorType on stderr with stdout empty. Capture both (--json 2>&1). See the pio-manager skill for the full contract.

Purpose

Use this skill for the common ESP32 workflow: build, flash, monitor, diagnose, patch, and retry.

Safety Rules

  • Ask before flashing.
  • Do not erase flash unless explicitly requested.
  • Stop active serial monitors before upload if the port is busy.
  • Save build and serial logs.

Workflow

  1. Inspect platformio.ini, run pio-agent devices, and call pio-agent target-resolve for one explicit ESP32 environment.
  2. Confirm the resolved board, stable device fingerprint, and short-lived binding; stop on ambiguity.
  3. Run pio-agent agent-safe-pin-audit --project-dir <dir> --board <id> for ESP32 strapping, input-only, and flash/SPI pin risks.
  4. Build with pio-agent agent-build-diagnose --project-dir <dir> --environment <env> and preserve its task/log references.
  5. Summarize build result, including RAM and flash usage if available.
  6. Ask user approval before flashing.
  7. Call pio-agent agent-flash-monitor-verify --project-dir <dir> --environment <env> --port <p> with the approved target binding and bounded --expect-all/--reject-patterns markers.
  8. Allow --start-monitor on the flash to reattach the monitor after USB re-enumeration only when the device fingerprint still matches.
  9. Use pio-agent logs capture or pio-agent monitor-health for additional bounded evidence.
  10. Diagnose boot loops, watchdogs, brownouts, panic output, or missing markers and suggest the smallest next change.

Common Board IDs

esp32dev
esp32-s3-devkitc-1
esp32-c3-devkitm-1
nodemcu-32s
lolin_s2_mini
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 25d ago Changed · +6 lines 324dc94f8521
  2. 1mo ago Changed · +55 tokens per session 7928b931443d
  3. 1mo ago First seen · 41 lines · 0 tokens per session scan A a86d2072d0ab

Subscribe to this mod's changes

esp32-flash-monitor is a skill published in the GitHub repository jl-codes/platformio-mcp (54 stars, last pushed 16d ago), licensed MIT. It adds 55 tokens to every session and 546 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

gke-compute-classes

Configures, optimizes, and troubleshoots GKE ComputeClasses. Use when configuring Spot VMs with on-demand fallback, targeting specific accelerators (GPUs/TPUs) or machine families, restricting ComputeClass access, or debugging pending pods related to node pool auto-creation. Do not use for cluster-level Node Auto…

google/skills · 83 tokens

jetson-diagnostic

Read-only Jetson health snapshot for identity, memory, GPU, thermal, power, storage, services, and top processes.

NVIDIA/skills · 30 tokens

holoscan-install-wheel

Install Holoscan SDK 5.x CUDA 13 Python wheels in an isolated environment, choosing the full stack or version-matched components.

NVIDIA/skills · 34 tokens

offensive-z-wave

Z-Wave attack methodology — sniffing with Z-Force / EZ-Wave / RTL-SDR + ZniffMobile, S0 (legacy) network-key derivation flaw and key reuse, S2 (modern) ECDH commissioning analysis, replay/injection on unauthenticated nodes, default-key brute-force on test deployments, and home-automation hub pivots. Use when targeting…

SnailSploit/Claude-Red · 113 tokens

doca-socket-relay

Use this skill when the operator is driving the DOCA Socket Relay to bridge a socket-oriented host application onto a BlueField DPU peer without rewriting it — picking the deployment shape (in-process, sidecar, or BlueField service container), configuring the host-side socket and the DPU-side forwarding endpoint…

NVIDIA/skills · 236 tokens

hsb-flash

Flash the FPGA on an HSB board connected to an NVIDIA devkit. Supports HSB Lattice boards (FPGA versions 2407, 2412, 2507, 2510) and Leopard Imaging VB1940 "all-in-one" cameras (FPGA versions 2507, 2510). Uses release-specific YAML manifests and board-type-specific program commands. Lattice and VB1940 commands must…

NVIDIA/skills · 94 tokens