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