Practical guide for creating human-readable and agent-parseable diagrams using Mermaid. Includes conservative, renderer-compatible templates and when-to-use guidance.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Mermaid Diagrams Skill
This skill provides:
- A conservative set of Mermaid templates that render on older renderers (VS Code/Markdown previewers, Git platforms) and remain clear to humans.
- Guidance on which diagram type to use for which situation.
- Compatibility tips and fallbacks when advanced Mermaid types are unavailable.
## Compatibility Rules (Read First)
- Prefer `graph LR`/`graph TB` for flowcharts; some renderers fail on `flowchart` keyword.
- Quote labels containing spaces/special characters: `A["Text (x|y) |"]`.
- **Do not use literal `\n` inside labels** - Mermaid does not interpret such line breaks. Use `<br/>` for line breaks.
- Advanced types like `quadrantChart`, `sankey-beta`, `requirementDiagram`, `gitGraph` may not be available. Use provided flowchart fallbacks.
- Code fences must start at column 0 with language `mermaid`.
## ASCII/Unicode Sidecar (Human-Readable Raw Markdown)
To optimize for quick human scanning in raw Markdown and robust parsing by agents, always ship an ASCII/Unicode sidecar immediately below each Mermaid block.
Policy:
- MUST include a monospace, text-only diagram right under the Mermaid block using fenced code with language `text`.
…
The line at the top of this page pins the label git:20260828.e6ca64d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_dbkm4es55crlulyr
GET https://markdownregistry.com/api/v1/resolve?ref=desko77/cursor-1c-skills/mermaid-diagrams
GET https://markdownregistry.com/api/v1/blob/876a1cb659b714e24fb0c4666b0ed98e87f224ffc1c6e64ecbe7965571827fe9
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
desko77/cursor-1c-skills · skills/1c-bsl-validate/SKILL.md · Проверка вызовов общих модулей в BSL по выгрузке конфигурации - существует ли модуль и экспортный ли у него метод…
desko77/cursor-1c-skills · skills/1c-bsp-registration/SKILL.md · Добавить функцию регистрации БСП (СведенияОВнешнейОбработке) в модуль объекта обработки
desko77/cursor-1c-skills · skills/1c-cf-add-object/SKILL.md · Добавить объект метаданных в конфигурацию 1С с формой, подсистемой и валидацией. Workflow: meta-compile → cf-edit →…
desko77/cursor-1c-skills · skills/1c-cf-edit/SKILL.md · Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить…
desko77/cursor-1c-skills · skills/1c-cf-init/SKILL.md · Создать пустую конфигурацию 1С (scaffold XML-исходников). Используй когда нужно начать новую конфигурацию с нуля
desko77/cursor-1c-skills · skills/1c-cf-new-project/SKILL.md · Создать новую конфигурацию 1С с нуля - scaffold + объекты + подсистемы + роли + формы. Workflow: cf-init →…
desko77/cursor-1c-skills · skills/1c-cf-validate/SKILL.md · Валидация конфигурации 1С. Используй после создания или модификации конфигурации для проверки корректности
desko77/cursor-1c-skills · skills/1c-cfe-borrow/SKILL.md · Заимствование объектов из конфигурации 1С в расширение (CFE). Используй когда нужно перехватить метод, изменить форму…
nicepkg/ai-workflow · workflows/talk-to-slidev-workflow/.claude/skills/mermaid-diagrams/SKILL.md · Create diagrams and visualizations using Mermaid syntax. Use when generating flowcharts, sequence diagrams, class…
desko77/claude-code-skills-1c · skills/mermaid-diagrams/SKILL.md · Practical guide for creating human-readable and agent-parseable diagrams using Mermaid. Includes conservative…
jjmartres/ai-coding-agents · shared/.ai-agents/skills/mermaid-diagrams/SKILL.md · Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or…
ahundt/autorun · plugins/autorun/skills/mermaid-diagrams/SKILL.md · Render Mermaid diagrams to SVG using beautiful-mermaid and bun. Use when the user asks to "render mermaid", "generate…
vecnode/vn-code · packages/dsh-diagrams/skills/mermaid-diagrams/SKILL.md · Author Mermaid diagrams that parse the first time: choose the right diagram type for the question, write syntax the…
vecnode/vncode · packages/dsh-diagrams/skills/mermaid-diagrams/SKILL.md · Author Mermaid diagrams that parse the first time: choose the right diagram type for the question, write syntax the…
pantheon-org/tekhne · skills/documentation/mermaid-diagrams/SKILL.md · Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or…