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

mermaid-diagramming — скилл для Claude Code

Скилл mermaid-diagramming учит агента рисовать диаграммы Mermaid: блок-схемы, sequence-диаграммы, ERD, состояния, Gantt и архитектурные виды, отдельно базовую и стилизованную версию.

MIT 105 установок ★ 71 обновлён 2026-06-29

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

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

Скилл ведёт агента по четырём шагам: сначала разобраться, что и для кого рисуем, потом написать код Mermaid, добавить тему и подписи, а в конце отдать инструкцию по рендеру. Таблица выбора типа подсказывает, когда нужен flowchart, когда sequenceDiagram, а когда erDiagram или gantt.

Синтаксис и примеры лежат в references/diagram-types.md. Структуру скилл ограничивает: меньше 15 узлов на диаграмму, осмысленные подписи вместо одиночных букв, группировка через subgraph. Стили задаются директивами %%{init: ...}%% и classDef, а для доступности нужны контраст и alt-текст при вставке картинки.

На выходе просят две версии: чистую, которая отрендерится где угодно, и стилизованную, плюс пометку, где смотреть результат. В зависимостях указан скилл documentation-production, из инструментов агенту нужны Read и Write. Если рендерера Mermaid в проекте нет, остаётся экспорт в SVG или PNG, и решить это стоит до того, как диаграмма уйдёт в документацию.

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

  • нарисовать блок-схему процесса по текстовому описанию
  • собрать sequence-диаграмму для вызовов API
  • построить ERD по схеме базы
  • разложить этапы проекта в Gantt
  • оформить диаграмму так, чтобы она читалась на GitHub

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

  • Нарисуй sequence-диаграмму Mermaid для обмена токенами между клиентом и API.
  • Сделай ERD по таблицам из schema.sql.
  • Добавь в README блок-схему деплоя и стилизованный вариант с темой.

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

1Через Skills CLI (Vercel)

npx skills add NickCrew/Claude-Cortex --skill mermaid-diagramming -a claude-code

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

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

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

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

Вопросы о mermaid-diagramming

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

Выполните npx skills add NickCrew/Claude-Cortex --skill mermaid-diagramming -a claude-code. Скилл встанет в ~/.claude/skills/mermaid-diagramming/SKILL.md.

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

Помогает агенту строить диаграммы Mermaid: блок-схемы, sequence, ERD, состояния, классы, Gantt, архитектурные виды. Скилл задаёт порядок работы, правила структуры и стилизации.

Что нужно, чтобы скилл заработал?

В зависимостях указан скилл documentation-production. Из инструментов агенту нужны Read и Write.

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

SKILL.md · MIT
---
name: mermaid-diagramming
description: Mermaid diagram creation covering flowcharts, sequence diagrams, ERDs, state machines, Gantt charts, and architecture views. Use when creating or updating technical diagrams in documentation.
version: 1.0.0
tags:
  - mermaid
  - diagrams
  - visualization
  - documentation
triggers:
  - mermaid diagram
  - flowchart
  - sequence diagram
  - entity relationship diagram
  - state diagram
  - gantt chart
  - architecture diagram
  - class diagram
dependencies:
  skills:
    - documentation-production
  tools:
    - Read
    - Write
token_estimate: ~2500
keywords:
  - create diagram
  - flowchart
  - sequence diagram
  - ERD
  - mermaid
  - diagramming
  - mermaid diagramming
---

# Mermaid Diagramming

Create clear, professional Mermaid diagrams for technical documentation. Covers all major
diagram types with both basic and styled variants, rendering guidance, and export recommendations.

## When to Use This Skill

- Creating flowcharts for process documentation or decision trees
- Drawing sequence diagrams for API interactions or system communication
- Building ERDs for database schema documentation
- Designing state machine diagrams for workflow states
- Producing Gantt charts for project timelines
- Documenting system architecture with C4 or network diagrams
- Adding visual aids to README files, ADRs, or design docs

## Quick Reference

| Resource | Purpose | Load when |
|----------|---------|-----------|
| `references/diagram-types.md` | Syntax, patterns, and code examples for every Mermaid diagram type | Choosing or building a diagram |

---

## Workflow Overview

```
Phase 1: Scope     → Identify what to visualize, audience, and diagram type
Phase 2: Draft     → Write base Mermaid code with correct syntax
Phase 3: Style     → Add theming, colors, and accessibility annotations
Phase 4: Deliver   → Provide rendering instructions and suggest iterations
```

---

## Phase 1: Scope

Before writing any code, clarify:

1. **What is the narrative?** The diagram should tell a story or answer a question.
2. **Who is the audience?** Developers need detail; stakeholders need overview.
3. **What entities and relationships exist?** List nodes and edges before drawing.
4. **Which diagram type fits?** Use the selection guide below.

### Diagram Type Selection

| If you need to show... | Use |
|------------------------|-----|
| Process flow, decisions, branching | `flowchart` |
| Interactions over time between systems/actors | `sequenceDiagram` |
| Data model and relationships | `erDiagram` |
| Object structure and inheritance | `classDiagram` |
| States and transitions | `stateDiagram-v2` |
| Project schedule and dependencies | `gantt` |
| Proportions or distribution | `pie` |
| Hierarchical idea mapping | `mindmap` |
| Events over time | `timeline` |
| System architecture layers | C4 context/container diagrams |
| Code version history | `gitGraph` |
| User experience flow | `journey` |

---

## Phase 2: Draft

### Structure Rules

1. **One concept per diagram** — split complex systems into multiple views
2. **Limit nodes** — keep under 15 nodes per diagram; split if larger
3. **Meaningful labels** — use descriptive text, not single letters
4. **Consistent direction** — prefer top-to-bottom (`TB`) or left-to-right (`LR`)
5. **Group related nodes** — use `subgraph` to cluster related elements

### Code Conventions

```mermaid
%% Always start with a comment describing the diagram's purpose
%% Use consistent quoting for labels with special characters
flowchart LR
    A["User Request"] --> B{"Auth Check"}
    B -->|Valid| C["Process Request"]
    B -->|Invalid| D["Return 401"]
```

- Use double quotes for labels containing special characters
- Add comments (`%%`) explaining non-obvious relationships
- Prefer `-->` for solid lines, `-.->` for dashed, `==>` for thick
- Use descriptive edge labels: `-->|"reason"| TargetNode`

---

## Phase 3: Style

### Theming

Apply consistent styling using `%%{init: ...}%%` directives:

```mermaid
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#4A90D9'}}}%%
flowchart TB
    A["Start"] --> B["End"]
```

### Node Styling

```mermaid
flowchart LR
    A["Normal"]
    B["Highlighted"]:::highlight
    classDef highlight fill:#f9f,stroke:#333,stroke-width:2px
```

### Accessibility

- Use high-contrast color combinations
- Do not rely on color alone to convey meaning — add labels and shapes
- Include alt text when embedding: `![Diagram description](path)`
- Provide a text summary alongside complex diagrams

---

## Phase 4: Deliver

### Always Provide

1. **Basic version** — clean, unstyled diagram that renders anywhere
2. **Styled version** — themed variant with colors and emphasis
3. **Rendering note** — where to preview (GitHub, Mermaid Live, VS Code extension)
4. **Suggestions** — complementary diagrams or next iterations

### Rendering Options

| Platform | Support |
|----------|---------|
| GitHub markdown | Native rendering in `.md` files |
| GitLab markdown | Native rendering |
| Mermaid Live Editor | `https://mermaid.live` for interactive editing |
| VS Code | Mermaid extension for preview |
| Docusaurus / MkDocs | Plugin-based rendering |

### Export Formats

- **SVG**: Best for web and docs (scalable, searchable text)
- **PNG**: Fallback for platforms without Mermaid support
- **PDF**: For print or formal documentation

---

## Best Practices

- **Start simple** — get the structure right before adding style
- **Test rendering** — verify on the target platform before committing
- **Version diagrams** — update diagrams when the underlying system changes
- **Colocate with docs** — keep diagrams in the same directory as related documentation
- **Use subgraphs** — group related nodes to reduce visual complexity

## Anti-Patterns

- Putting too many nodes in one diagram (split at 15+ nodes)
- Using single-letter node IDs without labels
- Relying on color alone to convey meaning
- Hard-coding pixel widths that break on different renderers
- Leaving diagrams out of date after system changes

© NickCrew · MIT · NickCrew/Claude-Cortex

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

Все скиллы по теме «Тексты и документация» →
mermaid-diagrams softaworks Плагин mermaid-diagrams для Claude Code помогает создавать диаграммы архитектуры, потоков данных и процессов прямо в редакторе. Запускается, когда нужно визуализировать структуру кода или задокументировать систему через схемы. ★ 2 707звёзд репо agent-mermaid-diagram-specialist softaworks Плагин agent-mermaid-diagram-specialist для Claude Code генерирует диаграммы Mermaid: flowchart, sequence diagram, ERD и архитектурные схемы. Визуализирует процессы, связи в базе и взаимодействие компонентов. ★ 2 707звёзд репо mermaid-visualizer axtonliu Скилл mermaid-visualizer преобразует текст в профессиональные диаграммы Mermaid. Помогает визуализировать процессы, архитектуру систем, сравнения и иерархии, автоматически избегая синтаксических ошибок. CX Codex +1 1 700установок mermaid coco-research Команда строит диаграммы Mermaid (блок-схемы, sequence, state, class, ER, XY-графики) в SVG, HTML или ASCII для терминала. CX Codex +1 ★ 328звёзд репо mermaid-graph-writer curiositech Скилл mermaid-graph-writer генерирует синтаксис схем Mermaid по текстовым описаниям или коду. Помогает визуализировать переходы состояний, архитектуру и потоки данных. CX Codex +1 154установок mermaid-diagram-generator patricio0312rev Скилл mermaid-diagram-generator для Claude Code генерирует диаграммы Mermaid в markdown: блок-схемы, последовательности, ERD, состояния и классы. Срабатывает на запросы «Mermaid-диаграмму», «блок-схему» или «диаграмму архитектуры». CX Codex +1 348установок

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

Весь набор →
ux-review Скилл ux-review проверяет компонент или поток с трёх сторон: удобство, доступность по WCAG 2.1 AA и поведение интерфейса. Отдаёт отчёт с находками по приоритетам. CX Codex +1 119установок event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы на событиях: event sourcing, CQRS, саги и обмен сообщениями. Охватывает микросервисы и распределённые транзакции. CX Codex +1 118установок dashboard-designer Скилл dashboard-designer для Claude Code помогает спроектировать дашборд: выбрать KPI, расположить блоки и настроить визуальную иерархию. Запускается на запросы о структуре панели мониторинга или выборе BI-инструмента. CX Codex +1 109установок terraform-best-practices Скилл terraform-best-practices внедряет инженерные стандарты Terraform: разбиение на модули, блокировку стейта, разделение сред и валидацию в CI/CD. CX Codex +1 109установок kubernetes-security-policies Скилл kubernetes-security-policies для Claude Code помогает настроить Pod Security Standards, сетевые политики и RBAC в Kubernetes. Ужесточает защиту прод-окружения. CX Codex +1 104установок user-journey-mapping Скилл user-journey-mapping для Claude Code помогает составить карту пути пользователя с этапами, точками контакта, эмоциями и проблемами. Запускается при анализе пользовательского опыта или конверсии. CX Codex +1 102установок tutorial-design Скилл tutorial-design помогает проектировать пошаговые туториалы, воркшопы и практические руководства с контрольными точками и разбором частых ошибок. CX Codex +1 102установок requirements-discovery Скилл requirements-discovery для Claude Code помогает собирать требования, определять границы проекта и готовить PRD. Запускается при обсуждении новой функции, интервью со стейкхолдерами или проверке спецификации. CX Codex +1 101установок

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

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