К основному содержанию
скилл CX Codex

freertos-patterns — скилл для Claude Code: что делает и как установить

Скилл freertos-patterns подсказывает паттерны FreeRTOS на ESP32 и многоядерную координацию на RP2040 — очереди, мьютексы, задачи, уведомления.

MIT 120 установок ★ 33 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a claude-code
Открыть на GitHub

Что делает freertos-patterns

Скилл срабатывает на запросы про конкурентные задачи на ESP32 или ядра setup1/loop1 на RP2040: приоритеты, очереди, мьютексы, семафоры, уведомления задач, watchdog, event groups и таймеры. Вместо общего совета он подгружает один из пяти справочников — по созданию задач, очередям, синхронизации, памяти или продвинутым темам — в зависимости от того, какая именно проблема у пользователя.

Правила внутри конкретные: в задаче FreeRTOS никогда не использовать delay(), только vTaskDelay() или блокировку по событию; размер стека проверять через uxTaskGetStackHighWaterMark(), а не угадывать. Для ESP-IDF и Arduino/RP2040 примеры не взаимозаменяемы — у каждого порта свои единицы стека, affinity и правила критических секций, копировать пример между фреймворками скилл явно запрещает.

Скилл не предназначен для Arduino UNO и других однопроцессорных плат — там советует простой millis()-шедулер. Для архитектуры задач и бюджета времени он отсылает к realtime-control-design, а для готового скетча — к arduino-code-generator.

Какие задачи решает

  • выбрать между очередью, мьютексом и уведомлением задачи
  • проверить стек задачи на ESP32 через uxTaskGetStackHighWaterMark
  • развести владение данными между ядрами RP2040 в setup1 и loop1
  • найти причину дедлока из-за несогласованного порядка блокировок
  • отличить задачу FreeRTOS от простого делей-цикла на UNO

Примеры запросов агенту

  • Спроектируй синхронизацию между двумя задачами FreeRTOS на ESP32 через очередь
  • Помоги разделить работу между ядрами RP2040 в setup1 и loop1 без гонок за данные
  • Проверь, не переполнится ли стек у этой задачи FreeRTOS

Как установить freertos-patterns

1Через Skills CLI (Vercel)

npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a claude-code

2Вручную: положить файлы

~/.claude/skills/freertos-patterns/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/freertos-patterns/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о freertos-patterns

Как установить freertos-patterns в Claude Code?

Выполните npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a claude-code, скилл появится в ~/.claude/skills/freertos-patterns/SKILL.md.

Что делает скилл freertos-patterns?

Он подбирает паттерны FreeRTOS для ESP32 и многоядерной координации для RP2040 — создание задач, очереди, мьютексы, семафоры, уведомления, watchdog — и открывает подходящий справочник под конкретную проблему.

Для каких плат не подходит freertos-patterns?

Скилл не применяется к Arduino UNO и другим однопроцессорным платам, а также когда задачу решает обычный шедулер на millis() без конкурентности.

Исходный текст

SKILL.md · MIT
---
name: freertos-patterns
description: Use when users need ESP32 FreeRTOS or RP2040 multicore patterns for task creation, queues, synchronization, memory checks, task notifications, or cross-core coordination.
metadata: {triggers: "FreeRTOS, multicore, task, queue, mutex, cross-core"}
---

# FreeRTOS Patterns for ESP32 and RP2040

Use this skill for real concurrency problems on ESP32 or RP2040. Keep the main
flow focused and load the detailed reference that matches the user's exact
problem.

## Resources

- `references/patterns-task-creation.md` - task lifecycle, priorities, stack
  sizing, and task startup
- `references/patterns-queues.md` - inter-task communication with queues
- `references/patterns-synchronization.md` - mutexes, semaphores, critical
  sections, and ISR coordination
- `references/patterns-memory.md` - stack sizing, heap checks, and monitoring
- `references/patterns-advanced.md` - watchdogs, notifications, event groups,
  timers, and affinity
- `assets/workflow.mmd` - architecture overview

## When to Use

Use this skill when the request includes:

- multiple concurrent jobs on ESP32
- task priorities or preemption
- queue, semaphore, mutex, or notification design
- RP2040 `setup1` and `loop1` multicore coordination
- watchdog-safe long-running behavior
- debugging race conditions, stack overflows, or deadlocks

Do not use this skill when:

- the target is UNO or another single-core board
- a simple `millis()` scheduler solves the problem
- the request is only about one blocking loop with no concurrency requirement

## Workflow

For a control system's task/resource ownership, action timing or deadline
budget, start with `realtime-control-design`. Return here for the actual RTOS
primitive. Native ESP-IDF uses its own port's stack units, affinity and critical
section rules; do not copy an Arduino/RP2040 example into another framework
without checking the selected SDK.

1. Confirm the target platform first:
   - ESP32 -> FreeRTOS task model
   - RP2040 -> dual-core coordination model
2. Identify the dominant problem:
   - task startup -> open `patterns-task-creation.md`
   - communication -> open `patterns-queues.md`
   - shared data or ISR signaling -> open `patterns-synchronization.md`
   - stack or heap risk -> open `patterns-memory.md`
   - watchdogs, notifications, timers, or affinity -> open
     `patterns-advanced.md`
3. Solve one synchronization boundary at a time. Avoid mixing queue, mutex, and
   notification advice unless the design truly needs all of them.
4. Keep board-specific details explicit. ESP32 FreeRTOS guidance and RP2040
   multicore guidance are not interchangeable.

## Core Rules

- Prefer the smallest concurrency primitive that solves the problem.
- Protect shared state explicitly. "Probably safe" is not safe.
- Use `vTaskDelay()` or event-driven blocking on ESP32, never `delay()` inside
  a task.
- Budget stack size deliberately and verify it with runtime evidence.
- For RP2040, define core ownership clearly before sharing data.

## Verification

- Confirm each task or core has a single clear responsibility.
- Check queue depth, notification flow, or mutex coverage against the concrete
  data path.
- For ESP32, inspect stack headroom with
  `uxTaskGetStackHighWaterMark()` where the task size is uncertain.
- Verify the sketch can keep making progress without deadlock or busy waiting.
- If an ISR is involved, verify the synchronization primitive is ISR-safe for
  that platform.

## Common Failure Modes

- undersized task stack
- `delay()` used inside a FreeRTOS task
- unprotected shared data
- deadlock from inconsistent lock order
- RP2040 core startup assumptions without mutex or ownership discipline

## Integration

- Combine with `arduino-code-generator` when the user needs a full sketch rather
  than design guidance.
- Combine with `circuit-debugger` only after the concurrency design looks sound
  and a hardware timing issue still remains.
- Combine with `mermaid-diagram-generator` when the concurrency design needs a
  task, queue, or event-flow diagram.

## Shared Output Contract

Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.

© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills

Похожие скиллы

Все скиллы по теме «Языки программирования» →
freertos mohitmishra786 Помогает писать код для FreeRTOS: создавать задачи, передавать данные через очереди, ловить переполнение стека и отлаживать потоки в GDB. CX Codex +1 739установок embedded-systems https://github.com/Jeffallan Скилл embedded-systems настраивает агента на разработку прошивок для STM32 и ESP32. Он помогает писать драйверы, FreeRTOS-задачи и оптимизировать потребление памяти и энергии. CX Codex +1 7 300установок embedded-iot travisjneuman Скилл embedded-iot по встраиваемым системам: паттерны GPIO, I2C и MQTT, задачи FreeRTOS и правила энергосбережения для ESP32, STM32 и Arduino. CX Codex +1 212установок esp32-ai-agent-skill ezrover Плагин esp32-ai-agent-skill для Claude, который подбирает чип ESP32, проверяет назначение GPIO и генерирует код под Arduino и ESP-IDF. ★ 59звёзд репо esp32-firmware-engineer adamlipecz Скилл esp32-firmware-engineer помогает писать, проверять и отлаживать прошивки ESP32 на ESP-IDF. При работе с железом сначала выясняет плату, вариант чипа и подключённые устройства. CX Codex +1 1 500установок low-power-embedded mohitmishra786 Скилл low-power-embedded для Claude Code и Codex: настройка режимов низкого энергопотребления микроконтроллеров — сон, стоп, ждущий режим, отключение тактирования периферии и конфигурация пробуждения. CX Codex +1 397установок

Из того же набора19

Весь набор →
code-review-facilitator Скилл code-review-facilitator проверяет проекты Arduino, ESP32 и RP2040 на типичные ошибки, проблемы с памятью и недочёты структуры. Подходит для ревью перед публикацией или после новой функции. CX Codex +1 154установок readme-generator Скилл readme-generator генерирует README.md для проектов на Arduino, ESP32 и RP2040. Подходит, когда проект нужно документировать перед публикацией на GitHub. CX Codex +1 147установок sensor-calibration-workbench Скилл sensor-calibration-workbench ведёт калибровку CO2-сенсоров, тензодатчиков и других датчиков: от прогрева и эталонных измерений до хранения коэффициентов и проверки дрейфа. CX Codex +1 137установок i2c-bringup-diagnostician Скилл i2c-bringup-diagnostician помогает выявить сбои шины I2C на платах Arduino и ESP32: от подтяжки резисторов до ошибок библиотек. CX Codex +1 134установок ota-deployment-guardian Скилл ota-deployment-guardian защищает удалённые платы ESP32 и Arduino Uno R4 WiFi от окирпичивания при OTA-обновлениях. Помогает настроить откат прошивки и разобрать сбои сетевых портов. CX Codex +1 115установок mermaid-diagram-generator Скилл mermaid-diagram-generator для Claude Code строит диаграммы Mermaid по коду Arduino и описаниям встроенных систем. Показывает состояния, последовательности сигналов и архитектуру задач FreeRTOS. CX Codex +1 113установок field-power-and-connectivity-triager Скилл field-power-and-connectivity-triager для Claude Code помогает найти причину сбоев питания и связи, когда плата работает от USB, но ломается с рабочим источником. Проверяет просадки напряжения, пиковый ток, стабилизатор и проводку. CX Codex +1 113установок arduino-serial-monitor Скилл arduino-serial-monitor для Claude Code читает и анализирует вывод последовательного порта Arduino: логи загрузки, данные датчиков и ошибки связи. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой