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

mermaid-diagram-generator · wedsamuel1230 — скилл для Claude Code: диаграммы Mermaid

Скилл mermaid-diagram-generator для Claude Code строит диаграммы Mermaid по коду Arduino и описаниям встроенных систем. Показывает состояния, последовательности сигналов и архитектуру задач FreeRTOS.

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

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

Что делает mermaid-diagram-generator

Скилл помогает превратить поведение Arduino-скетча или встроенной системы в диаграмму Mermaid: блок-схему, схему состояний, временную диаграмму или последовательность протокола. Он выбирает тип схемы по задаче, а для небольших фрагментов кода предлагает обойтись без диаграммы, если она ничего не прояснит.

В комплекте есть CLI-скрипт scripts/generate_diagram.py, шаблоны references/diagram-templates.md, эвристики извлечения схем из кода и чек-лист проверки. Для схемы состояния скилл обращается к эвристикам, для временной диаграммы — к шаблонам; затем сверяет синтаксис Mermaid, уровень абстракции и соответствие имён состояний и сигналов исходному материалу. Для маленького фрагмента кода диаграмма может добавить лишнюю сложность — скилл прямо советует не строить её без ясной пользы.

Схемы задач FreeRTOS можно сочетать со скиллом freertos-patterns, а диаграмму для скетча — с arduino-code-generator. Для публикации в документации репозитория предусмотрена связка с readme-generator.

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

  • показать переходы между состояниями встроенной системы
  • превратить код Arduino в блок-схему
  • описать временную последовательность или обмен по протоколу
  • визуализировать связи задач FreeRTOS
  • добавить диаграмму Mermaid в документацию проекта

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

  • Построй схему состояний для этого кода Arduino и проверь, что переходы совпадают с исходником.
  • Покажи временную диаграмму обмена по протоколу из этого описания.
  • Визуализируй связи задач FreeRTOS для этой архитектуры.

Как установить mermaid-diagram-generator

1Через Skills CLI (Vercel)

npx skills add wedsamuel1230/embedded-engineering-skills --skill mermaid-diagram-generator -a claude-code

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

~/.claude/skills/mermaid-diagram-generator/SKILL.md

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

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

Вопросы о mermaid-diagram-generator

Как установить mermaid-diagram-generator в Claude Code?

Выполните npx skills add wedsamuel1230/embedded-engineering-skills --skill mermaid-diagram-generator -a claude-code. Файл скилла находится по пути ~/.claude/skills/mermaid-diagram-generator/SKILL.md.

Что делает mermaid-diagram-generator?

Он создаёт диаграммы Mermaid по коду Arduino и описаниям встроенных систем: например, схемы состояний, блок-схемы и временные диаграммы. Перед выдачей результата проверяет синтаксис и соответствие схемы исходным состояниям и сигналам.

Как скилл строит диаграммы для задач FreeRTOS?

Для архитектуры задач он использует эвристики анализа кода вместе с шаблонами диаграмм. Для таких схем его можно сочетать со скиллом freertos-patterns.

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

SKILL.md · MIT
---
name: mermaid-diagram-generator
description: Use when users need Mermaid diagrams for Arduino code structure, state machines, timing diagrams, task architecture, or workflow documentation.
metadata: {triggers: "Mermaid diagram, state machine diagram, timing diagram, workflow"}
---

# Mermaid Diagram Generator

Generate Mermaid diagrams from Arduino and embedded-system concepts without
loading unnecessary detail up front.

## Resources

- `scripts/generate_diagram.py` - CLI generator for diagram output
- `references/diagram-templates.md` - Mermaid templates by diagram type
- `references/code-patterns.md` - code-to-diagram extraction heuristics
- `references/validation-checklist.md` - rendering and syntax checks

## When to Use

Use this skill when the request asks to:

- visualize a state machine
- turn code into a flowchart
- document timing or protocol sequences
- show FreeRTOS task relationships
- add a diagram to project documentation

Do not use it for tiny code snippets where a diagram adds no clarity.

## Workflow

1. Identify the diagram type:
   - state flow -> open `references/code-patterns.md`
   - timing or protocol sequence -> open `references/diagram-templates.md`
   - task architecture -> open both `code-patterns.md` and
     `diagram-templates.md`
2. Prefer the simplest diagram that explains the behavior.
3. Use `scripts/generate_diagram.py` when the input is structured enough for
   automation.
4. Run through `references/validation-checklist.md` before presenting the final
   Mermaid output.

## Verification

- Mermaid syntax parses without errors.
- The diagram uses the correct abstraction level for the request.
- State names, transitions, or signals match the source material exactly.
- The output is readable without reverse-engineering the code.

## Integration

- Pair with `freertos-patterns` for task and synchronization diagrams.
- Pair with `arduino-code-generator` when a generated sketch also needs visual
  documentation.
- Pair with `readme-generator` when the diagram should ship in repository docs.

## 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

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

Все скиллы по теме «Тексты и документация» →

Сначала — mermaid-diagram-generator от других авторов.

mermaid-diagram-generator patricio0312rev Скилл mermaid-diagram-generator для Claude Code генерирует диаграммы Mermaid в markdown: блок-схемы, последовательности, ERD, состояния и классы. Срабатывает на запросы «Mermaid-диаграмму», «блок-схему» или «диаграмму архитектуры». CX Codex +1 348установок external-diagram-mermaid-generate forcedotcom Скилл external-diagram-mermaid-generate строит диаграммы Mermaid по архитектуре Salesforce: потоки OAuth, ERD, интеграции, структуру Agentforce. Резервный вариант в ASCII, если рендерер недоступен. CX Codex +1 5 600установок mermaid-diagram-specialist davila7 Скилл mermaid-diagram-specialist генерирует диаграммы Mermaid прямо в Markdown: от блок-схем и ER-диаграмм до C4 и таймлайнов. Пригодится при составлении технической документации и проектировании архитектуры. CX Codex +1 145установок agent-mermaid-diagram-specialist softaworks Плагин agent-mermaid-diagram-specialist для Claude Code генерирует диаграммы Mermaid: flowchart, sequence diagram, ERD и архитектурные схемы. Визуализирует процессы, связи в базе и взаимодействие компонентов. ★ 2 707звёзд репо mermaid-diagram-ui przeprogramowani Правило mermaid-diagram-ui инструктирует агента строить Mermaid-схемы фронтенда на Astro и React для модуля авторизации по файлу требований. CX Codex +1 ★ 267звёзд репо mermaid-diagram-journey przeprogramowani Правило mermaid-diagram-journey инструктирует Claude Code составить диаграмму пользовательских путей Mermaid для сценариев авторизации и регистрации на основе PRD проекта. CX Codex +1 ★ 267звёзд репо code-to-diagram zebbern Скилл code-to-diagram разбирает импорты в кодовой базе и строит архитектурные схемы, блок-схемы и иерархии файлов. Пригодится перед ревью или рефакторингом. CX Codex +1 ★ 4 719звёзд репо

Из того же набора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установок freertos-patterns Скилл freertos-patterns подсказывает паттерны FreeRTOS на ESP32 и многоядерную координацию на RP2040 — очереди, мьютексы, задачи, уведомления. CX Codex +1 120установок ota-deployment-guardian Скилл ota-deployment-guardian защищает удалённые платы ESP32 и Arduino Uno R4 WiFi от окирпичивания при OTA-обновлениях. Помогает настроить откат прошивки и разобрать сбои сетевых портов. CX Codex +1 115установок 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установок

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

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