beriberikix/zephyr-agent-skills

# Zephyr Agent Skills

The entry point for Zephyr RTOS development. Behind this are 20+ specialized skills
(`devicetree`, `build-system`, `connectivity-ble`, `testing-debugging`, and more) — but do not
guess which one to read. Skill selection is deterministic, via `zephyr-cli`.

## How to get the right skill

1. **Find it** — run `zephyr-cli skills suggest` with a short description of your task. Add
   `--kconfig` symbols or `--dts` compatibles when you know them. It returns the best-matching
   skills, ranked, with scores and the reasons each matched.
2. **Install it** — `zephyr-cli skills install NAME` fetches that skill's `SKILL.md` and its
   reference files into the workspace.
3. **Apply it** — read the installed `SKILL.md` and follow it.

# Skill Creator

This skill provides guidance for creating effective skills.

## About Skills

Skills are modular, self-contained packages that extend Claude's capabilities by providing
specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific
domains or tasks—they transform Claude from a general-purpose agent into a specialized agent
equipped with procedural knowledge that no model can fully possess.

### What Skills Provide

1. Specialized workflows - Multi-step procedures for specific domains

# Zephyr Board Bringup (HWMv2)

Bring your custom hardware into the Zephyr ecosystem using modern Hardware Model v2 standards.

## Core Workflows

### 1. Planning the Structure
Organize your board files by vendor and board name.
- **Reference**: **[hwmv2_structure.md](references/hwmv2_structure.md)**
- **Key Tools**: `board.yml`, naming conventions.

### 2. Defining Configuration
Implement the essential Kconfig and CMake logic.
- **Reference**: **[board_files.md](references/board_files.md)**

# Zephyr Build System

Efficiently manage the complex build and configuration stack of Zephyr RTOS.

## Core Workflows

### 1. West Workspace & Manifests
Manage multi-repo projects and dependency allow-lists.
- **Reference**: **[west.md](references/west.md)**
- **Key Tools**: `west init`, `west update`, `west manifest --resolve`, `name-allowlist`.

### 2. Kconfig Configuration
Tune software features and hardware parameters.
- **Reference**: **[kconfig.md](references/kconfig.md)**

# Zephyr Connectivity: BLE

Implement robust, low-power Bluetooth Low Energy applications using Zephyr's industry-standard BLE stack.

## Core Workflows

### 1. BLE Fundamentals
Set up advertising, define GATT services, and manage connections.
- **Reference**: **[ble_fundamentals.md](references/ble_fundamentals.md)**
- **Key Tools**: `BT_GATT_SERVICE_DEFINE`, `bt_le_adv_start`, `BT_CONN_CB_DEFINE`.

### 2. Send-When-Idle Pattern
Optimize radio usage by bundling data and transmitting only during idle periods.
- **Reference**: **[send_when_idle.md](references/send_when_idle.md)**

# Zephyr Connectivity: IP Networking

Build memory-efficient, cloud-connected applications using Zephyr's modular IP stack and industry-standard IoT protocols.

## Core Workflows

### 1. Protocol Selection
Choose the right protocol (LwM2M, CoAP, MQTT) based on your device's power and management needs.
- **Reference**: **[protocol_selection.md](references/protocol_selection.md)**
- **Key Tools**: `CONFIG_COAP`, `CONFIG_LWM2M`, `CONFIG_MQTT_LIB`.

### 2. IP Stack Configuration
Tune the networking stack to save Flash and RAM while ensuring reliable communication.
- **Reference**: **[ip_stack_config.md](references/ip_stack_config.md)**

# Zephyr Connectivity: USB & CAN

Build versatile hardware interfaces using Zephyr's modular USB device stack and robust CAN controller support.

## Core Workflows

### 1. USB Device Stack
Configure and enable standard USB classes for host communication.
- **Reference**: **[usb_device_stack.md](references/usb_device_stack.md)**
- **Key Tools**: `CONFIG_USB_DEVICE_STACK`, `usb_enable()`, CDC ACM, HID.

### 2. USB-to-CAN Integration
Implement high-performance bridge patterns for CAN bus diagnostics and adapters.
- **Reference**: **[usb_to_can.md](references/usb_to_can.md)**

# Zephyr Devicetree

The Devicetree (DT) is the source of truth for your hardware topology in Zephyr.

## Core Workflows

### 1. Understanding Syntax & Nodes
Nodes, properties, and phandles form the hierarchy.
- **Reference**: **[dt_syntax.md](references/dt_syntax.md)**
- **Key Tools**: Labels (`&label`), Properties (`reg`, `status`, `compatible`).

### 2. Working with Bindings
Mapping hardware descriptions to driver schemas.
- **Reference**: **[dt_bindings.md](references/dt_bindings.md)**

# Zephyr Hardware I/O

Interface with the physical world using Zephyr's standardized driver models and hardware abstraction layers.

## Core Workflows

### 1. Sensor Subsystem
Interact with various sensors using a uniform API for data fetching and decoding.
- **Reference**: **[sensors.md](references/sensors.md)**
- **Key Tools**: `sensor_sample_fetch`, `sensor_channel_get`, `struct sensor_value`.

### 2. Pinctrl & GPIO
Manage pin multiplexing, electrical configuration, and basic digital input/output.
- **Reference**: **[pinctrl_gpio.md](references/pinctrl_gpio.md)**

# Zephyr Industrial Protocols

Build robust, industry-standard communication systems using Zephyr's modular industrial protocol stacks.

## Core Workflows

### 1. Modbus RTU (Serial)
Implement serial-based industrial communication for meters, PLCs, and sensors.
- **Reference**: **[modbus_rtu.md](references/modbus_rtu.md)**
- **Key Tools**: `CONFIG_MODBUS`, RS-485 DE/RE handling, Register Mapping.

### 2. Modbus TCP
Bridge industrial data over standard Ethernet or Wi-Fi networks.
- **Reference**: **[modbus_tcp.md](references/modbus_tcp.md)**

# Zephyr IoT Protocols

Implement production-ready IoT communication using industry-standard mesh, wide-area, and cloud protocols.

## Core Workflows

### 1. OpenThread Mesh
Build robust, low-power mesh networks using the integrated OpenThread stack.
- **Reference**: **[openthread_integration.md](references/openthread_integration.md)**
- **Key Tools**: `CONFIG_NET_L2_OPENTHREAD`, `otInstance`, Thread Shell.

### 2. Matter-over-Thread
Create interoperable smart home devices using the Matter standard.
- **Reference**: **[matter_devices.md](references/matter_devices.md)**

# Zephyr Kernel Basics

Master the essential services that bring your Zephyr application to life.

## Core Workflows

### 1. Threads & Scheduling
Create and manage multi-threaded application flows.
- **Reference**: **[threads.md](references/threads.md)**
- **Key Tools**: `K_THREAD_DEFINE`, `k_sleep`, `k_yield`, Priorities.

### 2. Logging & Diagnostics
Implement layered logging for better observability and troubleshooting.
- **Reference**: **[logging.md](references/logging.md)**

# Zephyr Kernel Services

Move beyond basic threading and logging to build modular, event-driven, and robust Zephyr applications.

## Core Workflows

### 1. Event-Driven Communication (Zbus)
Decouple your modules using a lightweight publish-and-subscribe bus.
- **Reference**: **[zbus.md](references/zbus.md)**
- **Key Tools**: `ZBUS_CHAN_DEFINE`, `ZBUS_SUBSCRIBER_DEFINE`, `zbus_chan_pub`.

### 2. Behavioral Logic (SMF)
Manage complex system states and transitions using the State Machine Framework.
- **Reference**: **[smf.md](references/smf.md)**

# Zephyr Multicore Development

Leverage multiple CPU cores to increase performance, isolate critical tasks, and integrate heterogeneous systems.

## Core Workflows

### 1. SMP Configuration
Run the Zephyr kernel and your threads across multiple identical cores.
- **Reference**: **[smp_configuration.md](references/smp_configuration.md)**
- **Key Tools**: `CONFIG_SMP`, `k_spinlock`, Thread Affinity.

### 2. OpenAMP & RPMsg
Communicate between heterogeneous cores (e.g., A-series and M-series) using standard protocols.
- **Reference**: **[openamp_rpmsg.md](references/openamp_rpmsg.md)**

# Zephyr Native Simulation

Develop, test, and debug Zephyr applications with the speed and convenience of your host machine.

## Core Workflows

### 1. Simulation Basics
Understand when to use `native_sim` vs. QEMU and how to map host resources.
- **Reference**: **[simulation_basics.md](references/simulation_basics.md)**
- **Key Tools**: `west build -b native_sim`.

### 2. Host-Side Debugging
Use professional host tools to find the most elusive bugs.
- **Reference**: **[debugging.md](references/debugging.md)**

# Zephyr Power & Performance

Maximize the efficiency of your embedded system by balancing power consumption and computational performance.

## Core Workflows

### 1. Power Management (PM)
Implement system-level and peripheral-specific power saving strategies.
- **Reference**: **[power_management.md](references/power_management.md)**
- **Key Tools**: `pm_device_action_run`, `pm_state_set`, Residency hooks.

### 2. Performance Tuning
Optimize critical code paths and monitor system resources.
- **Reference**: **[performance_tuning.md](references/performance_tuning.md)**

# Zephyr Security & Updates

Build production-ready, secure embedded systems using Zephyr's modular security stack and MCUboot bootloader.

## Core Workflows

### 1. MCUboot Integration
Set up the secure bootloader and define fail-safe flash partitions.
- **Reference**: **[mcuboot_integration.md](references/mcuboot_integration.md)**
- **Key Tools**: `CONFIG_BOOTLOADER_MCUBOOT`, `fixed-partitions`, Devicetree.

### 2. Image Signing
Ensure firmware integrity with production-grade digital signatures.
- **Reference**: **[image_signing.md](references/image_signing.md)**

# Zephyr Specialized Hardware & Reliability

Integrate complex peripherals and build resilient systems that recover gracefully from unexpected failures.

## Core Workflows

### 1. LVGL GUI Development
Build sophisticated graphical user interfaces for LCD and TFT displays.
- **Reference**: **[lvgl_gui.md](references/lvgl_gui.md)**
- **Key Tools**: Widgets, Styles, Double Buffering, `native_sim` simulator.

### 2. Audio I2S & Codecs
Implement high-quality digital audio streaming and codec management.
- **Reference**: **[audio_i2s.md](references/audio_i2s.md)**

# Zephyr Storage

Implement reliable persistent data handling using Zephyr's storage subsystem and flash management utilities.

## Core Workflows

### 1. NVS Storage
Utilize Non-Volatile Storage (NVS) for efficient, wear-leveled data persistence.
- **Reference**: **[nvs_storage.md](references/nvs_storage.md)**
- **Key Tools**: `nvs_mount()`, `nvs_read()`, `nvs_write()`.

### 2. Flash Management
Configure and manage flash partitions and hardware page layouts.
- **Reference**: **[flash_management.md](references/flash_management.md)**

# Zephyr Testing & Debugging

Ensure code quality and system reliability using Zephyr's comprehensive testing framework and observability tools.

## Core Workflows

### 1. Ztest Framework
Write robust unit and integration tests for native simulation and real hardware.
- **Reference**: **[ztest_framework.md](references/ztest_framework.md)**
- **Key Tools**: `ZTEST_SUITE`, `ZTEST`, `zassert_equal`.

### 2. Twister Test Runner
Automate test execution across multiple platforms and generate professional reports.
- **Reference**: **[twister_testing.md](references/twister_testing.md)**

# Zephyr Foundations

Mastering the bedrock of Zephyr is essential for writing efficient, robust, and idiomatic code.

## Core Workflows

### 1. Idiomatic C Patterns
Zephyr uses specific macros to manage memory and hardware-software mapping.
- **Reference**: **[zephyr_macros.md](references/zephyr_macros.md)**
- **Key Tools**: `CONTAINER_OF`, `BIT()`, `GENMASK()`, `ARRAY_SIZE`.

### 2. Real-Time Concurrency
Safe multi-threading and interrupt handling are critical for stability.
- **Reference**: **[concurrency.md](references/concurrency.md)**

# Zephyr Index

The **Zephyr Index** is your entry point to a suite of specialized Agent Skills designed for professional Zephyr RTOS development. 

## When to Use
- You are starting a new Zephyr task and don't know which skill is relevant.
- You need a high-level overview of the Zephyr skill ecosystem.
- You want to navigate between foundational, common, and advanced Zephyr features.

## Quick Start (Skill Selection)
1. Open **[quick_reference.md](references/quick_reference.md)** and match your task category.
2. If the task spans multiple domains, follow **[decision_tree.md](references/decision_tree.md)**.
3. Open the selected skill `SKILL.md`, then load only the referenced docs needed for the current task.

# Zephyr Modules

Extend the Zephyr RTOS with reusable, out-of-tree modules that integrate seamlessly with the build system.

## Core Workflows

### 1. Defining a Module
Create the directory structure and metadata required for auto-discovery.
- **Reference**: **[module_definition.md](references/module_definition.md)**
- **Key Tools**: `zephyr/module.yml`, `zephyr/Kconfig`, `zephyr/CMakeLists.txt`.

### 2. West Manifest Integration
Adding your module to a workspace for distribution and versioning.
- **Reference**: **[west_integration.md](references/west_integration.md)**