---
name: format-mermaid
description: "Write Mermaid diagram syntax (flowchart, sequence, class, state, ER, Gantt, mindmap, timeline, C4, Kanban, architecture and other types) as fenced code that Markdown hosts render (README, GitHub/GitLab, wiki, blog), with live preview and PNG/SVG/PDF export when the `mermaid` MCP is connected. Use when the user wants Mermaid syntax or a quick text-to-diagram sketch. Not for a branded figure inside a PPTX, DOCX, PDF or deck (use format-diagram) and not for numeric data charts (use format-chart)."
allowed-tools: mcp__mermaid__mermaid_preview, mcp__mermaid__mermaid_save
metadata:
  stromy-client-summary: "Sketch a quick diagram for documentation or a wiki, written as text rather than drawn by hand."
---
<!--
  GENERATED FILE — DO NOT EDIT.
  Owner:       scripts/sync-mcp-skill-stubs.py (via sync-on-mcp-skill-change.yml)
  Source:      MCPs/stromy-format-mcp/skills/format-mermaid/SKILL.md
  This workflow pushes DIRECT to this repo's main — a local edit here will be
  overwritten or rejected non-fast-forward. Edit the source, push, then:
    gh workflow run sync-on-mcp-skill-change.yml -R stromy-org/stromy-org
  Hand-authored skill? Set `_local: true` in frontmatter instead.
-->

# Mermaid Diagrams (MCP-hosted skill)

This skill's full instructions are hosted on the `stromy-format` MCP server. Do not hardcode workflow logic locally — always fetch the live version from the MCP.

## Loading instructions

1. Read the main skill instructions:
   → call the `fs_read` tool on the `stromy-format` MCP with `path="skills/format-mermaid/SKILL.md"`.

   **Read it to the end.** `fs_read` returns one page at a time. If the result's `next_offset_chars` is not null — or the returned text ends in a `<<< PARTIAL READ … >>>` block — the body is incomplete: call `fs_read` again with `offset_chars` set to that value and concatenate, repeating until it comes back null. Do **not** start work on a partial skill body. Hard rules and anti-patterns often sit in the final third, and a partial read fails silently — it looks like a complete skill.

2. Discover reference files (and any other skill assets), then read on demand:
   → call `fs_list` with `path="skills/format-mermaid"` (and `path="skills/format-mermaid/references"`),
   → call `fs_read` with `path="skills/format-mermaid/references/<file>"`.

Follow the instructions returned by the MCP exactly.

## This MCP is the only correct path

Produce this skill's output **only** by following the live SKILL.md fetched above and calling the `stromy-format` MCP's own tools. Do **not** substitute a local or identically-named base skill from elsewhere, and do **not** invent your own output path. A locally-produced or unbranded artifact is **wrong output, not a fallback** — it bypasses the server-side brand and quality gates.