@mammothb/pi-mermaid

Pi skill that teaches the LLM to write Mermaid diagram syntax

Package details

skill

Install @mammothb/pi-mermaid from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@mammothb/pi-mermaid

Pi manifest JSON

{
  "skills": [
    "./skills"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Pi extension that renders Mermaid diagrams as ASCII art in the TUI, plus a skill that teaches the LLM to generate Mermaid syntax.

Extension: Auto-detects ```mermaid blocks in assistant responses and renders them as ASCII diagrams
Width-aware: Selects from 4 rendering presets (default/compact/tight/squeezed) based on terminal width
Validation: Parses Mermaid syntax via the official parser and reports errors
Collapsible: Large diagrams show first 10 lines with an expand hint
Command: /pi-mermaid manually re-renders the last assistant message
Skill: Teaches the LLM to write correct Mermaid syntax across 12+ diagram types

Flowchart, Sequence, Class, State, ER, Gantt, Pie, Git Graph, Mindmap, Timeline, C4, User Journey

pi install npm:@mammothb/pi-mermaid

Just include Mermaid blocks in your prompts — the extension auto-renders them:

```mermaid
flowchart TD
    A[Start] --> B{Ready?}
    B -->|Yes| C[Go]
    B -->|No| D[Wait]
```

Or use the command to render the last assistant message:

/pi-mermaid