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