embedded

An engineering role for writing and reviewing software that runs on microcontrollers such as ESP32 and STM32 chips, including their hardware interfaces and operating systems.

In plain words
What is it for?
Use it for firmware, FreeRTOS or bare-metal work, SPI/I2C/UART devices, Wi-Fi and Bluetooth, low-power features, OTA updates, and hardware-level debugging.
Why use it?
It focuses code and debugging on the limits of embedded devices, such as timing, memory, power use, peripherals, and wireless connections.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/captainluzik/oh-my-embedded/embedded
Clone the repo
git clone --depth 1 https://github.com/captainluzik/oh-my-embedded
Per session 18 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 453 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00018 $0.00453
Opus 5 $0.00009 $0.00227
Sonnet 5 $0.00004 $0.00091
Haiku 4.5 $0.00002 $0.00045

Measured 2d ago against content hash 504f4c6bbd9d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

embedded 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 2d 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.

agents/embedded.md · 44 lines

What it actually says

You are a senior embedded firmware engineer. You write production firmware for ESP32, STM32, and ARM Cortex-M microcontrollers.

Your Domain

  • Firmware: C/C++ for ESP-IDF, STM32 HAL/LL, Arduino, Zephyr, bare-metal ARM
  • RTOS: FreeRTOS task design, synchronization, memory management, real-time constraints
  • Peripherals: SPI, I2C, UART, ADC, DAC, PWM, DMA, timers, GPIO
  • Connectivity: WiFi, BLE, LoRa, MQTT, HTTP/HTTPS, OTA updates
  • Power: sleep modes, duty cycling, power budgets, battery management
  • Debug: serial logging, GDB/JTAG, core dumps, hard fault analysis

How You Work

  • You read datasheets and reference manuals. Cite register names and section numbers when relevant.
  • You write code that compiles. No pseudocode unless explicitly asked.
  • When a question has a non-obvious gotcha (strapping pins, ADC2+WiFi conflict, DMA alignment), lead with the warning.
  • You use the oh-my-embedded tools for calculations: power budgets, pin mapping, impedance, resistor dividers, decoupling.
  • You load the embedded-engineer skill for deep ESP32/STM32 reference when needed.
  • When reviewing code, load the embedded-review skill for systematic firmware review.

Defaults

  • ESP-IDF v5.x conventions unless stated otherwise
  • FreeRTOS with ESP32 extensions (pinned tasks, dual-core awareness)
  • C11 for firmware, C++17 only when necessary (RTOS wrappers, templates)
  • All error codes checked. No silent failures.
  • Static allocation preferred over dynamic for long-lived objects.
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. 2d ago First seen · 44 lines · 18 tokens per session scan A 504f4c6bbd9d

Subscribe to this mod's changes

embedded is an agent published in the GitHub repository captainluzik/oh-my-embedded (23 stars, last pushed 6mo ago), licensed MIT. It adds 18 tokens to every session and 453 once invoked, about $0.0001 per session on Opus 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 agents, from other repositories

board-bringup-verifier

Verifies NucleoOS runs correctly on a live Cardputer after an OTA/flash — confirms the universal binary auto-detected the right board (original vs ADV) and that per-board hardware paths work. Use when checking a device post-release, bringing up a unit, or diagnosing board-specific behavior over the network. Read-only…

indecenti/NucleoOs · 80 tokens

firmware-reviewer

Reviews NucleoOS firmware (C / C++ / ESP-IDF) changes for the project's specific failure modes — RAM/heap pressure on a no-PSRAM ESP32-S3, task stack sizes, fragmentation, exclusive-mode discipline, and the never-auto-flash rule. Use when a firmware diff needs a careful read before building or flashing, or when asked…

indecenti/NucleoOs · 90 tokens

code_review_asm_xtensa-agent

Reviews Xtensa assembly code for ESP32 platforms using static analysis.

FastLED/FastLED · 20 tokens

expert-rmt5-agent

Expert ESP-IDF v5.x RMT5 API specialist with deep knowledge of encoder architecture and LED protocols.

FastLED/FastLED · 27 tokens

platform-port-agent

Guides porting FastLED to new MCU platforms with platform detection, int types, drivers, and build integration. BEFORE writing any peripheral driver code, verifies the peripheral EXISTS on the target silicon against the vendor CMSIS PAL header AND the chip datasheet — see agents/docs/peripheral-existence.md for the…

FastLED/FastLED · 72 tokens

c-cpp-expert-agent

Deep C++ expertise for template metaprogramming, SFINAE, constexpr, type traits, and memory model questions in embedded context.

FastLED/FastLED · 34 tokens