freertos-patterns — скилл для Claude Code: что делает и как установить
Скилл freertos-patterns подсказывает паттерны FreeRTOS на ESP32 и многоядерную координацию на RP2040 — очереди, мьютексы, задачи, уведомления.
MIT 120 установок ★ 33 обновлён 2026-10-15
npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/freertos-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/freertos-patterns/
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a codex2Вручную: положить файлы
.agents/skills/freertos-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a cursor2Вручную: положить файлы
.cursor/skills/freertos-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wedsamuel1230/embedded-engineering-skills skills/freertos-patterns2Вручную: положить файлы
.github/skills/freertos-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/wedsamuel1230/embedded-engineering-skills --path skills/freertos-patternsВручную: положить файлы
.devin/skills/freertos-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill freertos-patterns -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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