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

mermaid-diagrams · oakoss — скилл для Claude Code: что делает и установка

Скилл mermaid-diagrams помогает создавать Mermaid-диаграммы в Markdown: от блок-схем и ERD до графиков, mindmap и архитектурных схем.

MIT 177 установок ★ 29 обновлён 2026-08-17

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

Что делает mermaid-diagrams

Скилл подсказывает синтаксис Mermaid для блок-схем, sequence-диаграмм, ERD, UML-классов, состояний, Gantt, pie chart, mindmap и git graph. Он также охватывает архитектурные, блочные, временные, Sankey-, XY-, quadrant-, Kanban-, packet-, requirement- и C4-диаграммы.

Внутри есть краткая таблица объявлений, правила для направлений, связей, атрибутов и блоков, а также список типичных ошибок. Материалы рассчитаны на диаграммы в Markdown, README и документации; для поиска существующих схем предлагается Explore, для проверки по коду — Task, а для архитектурной документации — code-reviewer.

Для вставки в Markdown нужен блок с языковой меткой mermaid: без неё кодовый блок не соответствует формату, который использует скилл. Пиксельные макеты и сложные пространственные композиции выходят за его задачу.

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

  • создать блок-схему процесса в Markdown
  • описать обмен сообщениями между сервисами
  • связать сущности базы данных через ERD
  • показать архитектуру и зависимости системы
  • собрать диаграмму сроков проекта

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

  • Построй Mermaid-блок-схему потока авторизации и вставь её в README.md.
  • Опиши связи таблиц из схемы базы данных через erDiagram.
  • Сделай sequence-диаграмму запроса между клиентом, API и базой данных.

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill mermaid-diagrams -a claude-code

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

~/.claude/skills/mermaid-diagrams/SKILL.md

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

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

Вопросы о mermaid-diagrams

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

Выполните npx skills add oakoss/agent-skills --skill mermaid-diagrams -a claude-code, затем проверьте файл ~/.claude/skills/mermaid-diagrams/SKILL.md.

Что делает mermaid-diagrams?

Скилл помогает писать Mermaid-синтаксис для диаграмм в Markdown и документации. Он даёт справку по типам диаграмм и разбирает частые ошибки в их коде.

Что нужно учесть при использовании Mermaid в Markdown?

Код нужно помещать в блок с языковой меткой mermaid. Скилл также советует использовать stateDiagram-v2 для синтаксиса диаграмм состояний и не смешивать версии.

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

SKILL.md · MIT
---
name: mermaid-diagrams
description: 'Mermaid diagram syntax for flowcharts, sequence diagrams, ERDs, class diagrams, and more. Use when creating diagrams in markdown, generating architecture visuals, or documenting system flows. Use for mermaid, diagram, flowchart, sequence, ERD, class-diagram, gantt, pie-chart, mindmap.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://mermaid.js.org/intro/'
---

# Mermaid Diagrams

## Overview

Mermaid is a JavaScript-based diagramming tool that renders Markdown-inspired text definitions into SVG diagrams. It supports flowcharts, sequence diagrams, ER diagrams, class diagrams, state diagrams, Gantt charts, pie charts, mindmaps, and git graphs directly inside Markdown files.

**When to use:** Documenting system architecture, visualizing data models, illustrating request flows, creating project timelines, embedding diagrams in GitHub/GitLab READMEs or docs sites.

**When NOT to use:** Pixel-perfect design mockups, interactive dashboards, diagrams requiring custom artwork or complex spatial layouts beyond hierarchical/relational structures.

## Quick Reference

| Diagram        | Declaration          | Key Points                                           |
| -------------- | -------------------- | ---------------------------------------------------- |
| Flowchart      | `flowchart TD`       | Directions: TB, TD, BT, RL, LR. Supports subgraphs   |
| Sequence       | `sequenceDiagram`    | Participants, messages, loops, alt/opt/par blocks    |
| ER Diagram     | `erDiagram`          | Crow's foot notation, PK/FK/UK attributes            |
| Class Diagram  | `classDiagram`       | UML relationships, visibility modifiers, annotations |
| State Diagram  | `stateDiagram-v2`    | Transitions, composite states, forks/joins, choice   |
| Gantt Chart    | `gantt`              | Sections, tasks with dates/durations, milestones     |
| Pie Chart      | `pie`                | Labels with numeric values, optional title           |
| Mindmap        | `mindmap`            | Indentation-based hierarchy, multiple node shapes    |
| Git Graph      | `gitGraph`           | Commits, branches, merges, cherry-picks, tags        |
| Architecture   | `architecture-beta`  | Services in groups, directional edges (T/B/L/R)      |
| Block Diagram  | `block-beta`         | Column layout, block arrows, nested blocks           |
| Timeline       | `timeline`           | Time periods with events, sections for grouping      |
| Sankey         | `sankey-beta`        | Flow quantities between nodes, CSV-like data format  |
| XY Chart       | `xychart-beta`       | Bar and line charts with x/y axes                    |
| Quadrant Chart | `quadrantChart`      | Four-quadrant plot with labeled axes and data points |
| Kanban         | `kanban`             | Columns with task cards, assignees, priorities       |
| Packet         | `packet-beta`        | Network packet structure with bit-range fields       |
| Requirement    | `requirementDiagram` | Requirements, elements, and verification links       |
| C4 Diagram     | `C4Context`          | C4 model: Context, Container, Component, Deployment  |

## Common Mistakes

| Mistake                                   | Correct Pattern                                            |
| ----------------------------------------- | ---------------------------------------------------------- |
| Using `graph` instead of `flowchart`      | Use `flowchart` for subgraph edges and newer features      |
| Missing space after arrow in sequences    | `Alice->>Bob: msg` not `Alice->>Bob:msg`                   |
| Wrong cardinality order in ER diagrams    | Left cardinality, then line, then right cardinality        |
| Forgetting `end` after subgraph/loop/alt  | Every block keyword requires a matching `end`              |
| Using reserved words as node IDs          | Wrap reserved words in quotes or use aliases               |
| Bare code blocks without language tag     | Always use ` ```mermaid ` as the language specifier        |
| Mixing v1 and v2 state diagram syntax     | Use `stateDiagram-v2` consistently for current features    |
| Unquoted labels with special characters   | Wrap labels containing special characters in double quotes |
| Missing `dateFormat` in Gantt charts      | Always declare `dateFormat` before task definitions        |
| Using tabs instead of spaces for mindmaps | Mindmap indentation requires spaces, not tabs              |

## Delegation

- **Diagram discovery and exploration**: Use `Explore` agent to find existing diagrams in the codebase
- **Diagram review**: Use `Task` agent to verify diagram accuracy against code
- **Architecture documentation**: Use `code-reviewer` agent for doc quality checks

## References

- [Flowcharts: nodes, edges, subgraphs, directions, and styling](references/flowcharts.md)
- [Sequence diagrams: participants, messages, activations, and control flow](references/sequence-diagrams.md)
- [Entity-relationship diagrams: entities, attributes, and cardinality](references/entity-relationship.md)
- [Class diagrams: classes, methods, relationships, and annotations](references/class-diagrams.md)
- [Other diagrams: Gantt, pie, mindmap, state, and git graph](references/other-diagrams.md)
- [Architecture, block, timeline, Sankey, XY chart, quadrant, kanban, packet, requirement, and C4 diagrams](references/extended-diagrams.md)

© oakoss · MIT · oakoss/agent-skills

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

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

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

mermaid-diagrams hoodini Скилл mermaid-diagrams для Claude Code и пяти других платформ — учит агента писать диаграммы Mermaid: блок-схемы, sequence, классы, ER, Gantt прямо в markdown. CX Codex +1 409установок mermaid-diagrams davila7 Скилл mermaid-diagrams для Claude Code — учит агента писать диаграммы Mermaid: классы, последовательности, ERD, C4, флоучарты. Документирует архитектуру и схемы БД. CX Codex +1 1 180установок utility-mermaid-diagrams product-on-purpose Скилл utility-mermaid-diagrams помогает создавать корректные диаграммы Mermaid для PRD и технических спецификаций, подбирая подходящий тип из 15 вариантов и проверяя синтаксис. CX Codex +1 829установок design-doc-mermaid SpillwaveSolutions Скилл design-doc-mermaid генерирует диаграммы Mermaid и техническую документацию по коду или описанию задачи. Подходит для оформления GitHub wiki, системных архитектур и схем баз данных. CX Codex +1 101 800установок architecture-diagrams aj-geddes Скилл architecture-diagrams помогает генерировать схемы архитектуры, потоки данных и C4-диаграммы в текстовом формате Mermaid или PlantUML. Пригодится при оформлении технической документации прямо в чате с агентом. CX Codex +1 2 000установок agent-mermaid-diagram-specialist softaworks Плагин agent-mermaid-diagram-specialist для Claude Code генерирует диаграммы Mermaid: flowchart, sequence diagram, ERD и архитектурные схемы. Визуализирует процессы, связи в базе и взаимодействие компонентов. ★ 2 707звёзд репо create_mermaid_visualization_for_github danielmiessler Промпт create_mermaid_visualization_for_github для Claude Code превращает описание сложной идеи в диаграмму Mermaid. Он также задаёт форматирование диаграммы для GitHub. GP ChatGPT ★ 44 690звёзд репо mermaid-graph-writer curiositech Скилл mermaid-graph-writer генерирует синтаксис схем Mermaid по текстовым описаниям или коду. Помогает визуализировать переходы состояний, архитектуру и потоки данных. CX Codex +1 154установок

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

Весь набор →
pdf-tools Скилл pdf-tools для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который покрывает весь цикл работы с PDF: извлечение текста и таблиц, генерацию, изменение и заполнение форм. CX Codex +1 186установок ssh-remote Скилл ssh-remote помогает ассистенту настраивать SSH-подключения, генерировать ключи Ed25519, пробрасывать порты и безопасно передавать файлы. CX Codex +1 183установок tanstack-hotkeys Скилл для агента: подсказывает, как собрать горячие клавиши в React на TanStack Hotkeys — от одиночных комбинаций до записи пользовательских шорткатов. CX Codex +1 179установок technical-docs Скилл technical-docs для Claude Code помогает писать и обновлять техническую документацию, строить диаграммы Mermaid и сверять документацию с кодом. Помогает вести doc-as-code и проверять покрытие. CX Codex +1 177установок motion Скилл обучает ИИ-агента правильно применять библиотеку Motion (framer-motion) в React и Next.js. Помогает настроить жесты, скролл-эффекты и избежать просадок FPS. CX Codex +1 176установок shadcn-ui Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod. CX Codex +1 176установок local-first Скилл local-first помогает решить, нужна ли веб-приложению локальная база с синхронизацией, и выбрать движок и стратегию разрешения конфликтов. CX Codex +1 173установок tanstack-query Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок

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

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