---

name: fix-mermaid description: "Validates and repairs mermaid diagrams in markdown files. Scans for mermaid blocks, validates syntax, and auto-repairs common errors." metadata: category: documentation is_workflow: false version: 1.0.0 tags: - documentation - validation - repair created: 2025-12-11 updated: 2026-02-26 author: cloud-on-prem/rp1 arguments: - name: FILE_PATH type: string required: true description: "Path to markdown file, or - for stdin diagram" sub_agents: - "rp1-base:mermaid-fixer"

Mermaid Diagram Fixer

This command validates and repairs Mermaid.js diagrams in markdown files.

Usage

/fix-mermaid path/to/file.md    # Process markdown file in-place
/fix-mermaid -                   # Process diagram from stdin (stdout output)

Invocation

{% dispatch_agent "rp1-base:mermaid-fixer", "INPUT_PATH: {FILE_PATH}, OUTPUT_MODE: in-place" %}

The agent will:

• Scan markdown for all mermaid code blocks
• Validate each diagram using rp1 CLI tool
• Attempt automatic repair (up to 3 iterations per diagram)
• Insert placeholders for unfixable diagrams
• Output JSON summary of repairs made

Requirements

• rp1 CLI v0.3.0 or later (includes agent-tools mmd-validate command)
• Chromium (auto-downloaded on first use by rp1)