Instruction file imported from akann/yana-stocks (.github/instructions/mermaid.instructions.md). Copyright stays with the author.

Mermaid AI Skills

When the user asks to create, edit, or visualize any diagram, use the Mermaid VS Code extension tools and commands described below.

Workflow

1. Determine the diagram type and generate Mermaid syntax.
2. Write the diagram to a .mmd file in the project.
3. Validate syntax: correct first-line keyword, arrow types, balanced brackets.
4. Preview via the Mermaid extension — open the .mmd file (auto-preview) or run MermaidChart: Preview Diagram (mermaidChart.preview).

LM Tools — call these for every diagram interaction

• mermaid-diagram-validator — validate Mermaid syntax before presenting any diagram
• mermaid-diagram-preview — render a live preview inside VS Code after generating
• get-syntax-docs-mermaid — fetch correct syntax docs for any diagram type

VS Code Commands

Invoke via Command Palette or the VS Code command API (GitHub Copilot in VS Code only). Do not invent command IDs. Prefer writing/editing .mmd files when a command is not needed.

Diagram editing & preview

• Preview (mermaidChart.preview) — preview the active Mermaid editor (.mmd / .mermaid must be open).
• Create Diagram (mermaidChart.createMermaidFile) — creates a demo flowchart and opens preview side by side.
• Repair Diagram (mermaidChart.repairDiagram) — Mermaid AI repair for the active diagram; uses Mermaid AI credits — tell the user before running.
• Improve Diagram (mermaidChart.improveDiagram) — uses Copilot / LM API; suggests layout + styling variants for the active diagram.

Generate diagrams (GitHub Copilot required)

• Generate Diagram from Code (mermaidChart.generateDiagramFromCode)
• Generate Cloud Diagram (mermaidChart.generateCloudDiagram)
• Generate ER Diagram (mermaidChart.generateERDiagram)
• Generate Docker Diagram (mermaidChart.generateDockerDiagram)
• Open AI Chat (mermaidChart.openCopilotChat)

Mermaid Chart cloud

• Login (mermaidChart.login) / Logout (mermaidChart.logout)
• Connect Diagram (mermaidChart.connectDiagramToMermaidChart) — link a local diagram to Mermaid Chart.
• Sync Diagram (mermaidChart.syncDiagramWithMermaid) — only for diagrams already connected (frontmatter has id:). Example:

  ---
  id: cbd9e9ba-a2cb-47c5-a98e-8c28a753428d
  ---

Review Mermaid Sync

For diagrams updated by the Mermaid Chart GitHub Sync app (or pre-commit regenerate):

• Review Mermaid Sync (mermaidChart.reviewAppCommits) — start / open the review flow.
• Regenerate with Mermaid AI (mermaidChart.regenerateDiagramWithMermaidAI) — regenerate from source references. Do not manually rewrite diagrams managed by this workflow. Accept/reject/diff UI actions stay in the extension UI.

Install / update this pack

• MermaidChart: Install AI Skills… (mermaidChart.installAiSkills)

@mermaid-chart slash commands

Rules

1. Always call mermaid-diagram-validator before showing any diagram.
2. Always call mermaid-diagram-preview after generating a diagram.
3. Use get-syntax-docs-mermaid before generating an unfamiliar diagram type.
4. Prefer @mermaid-chart slash commands for complex generation.
5. Write diagrams to .mmd files; never return unvalidated Mermaid syntax.
6. Warn the user before Repair (Mermaid AI credits).
7. Cooperate with the Sync workflow — do not manually regenerate managed diagrams.

Docs

More commands and features: https://marketplace.visualstudio.com/items?itemName=MermaidChart.vscode-mermaid-chart