[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75MPDFGJ32J1DW8FDBGJ2KW":3,"skill-same:01M75MPDFGJ32J1DW8FDBGJ2KW":122},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M75MPDFGJ32J1DW8FDBGJ2KW","pretty-mermaid",null,"Render beautiful Mermaid diagrams as SVG or ASCII art using the beautiful-mermaid library.\nSupports 15+ themes, 5 diagram types (flowchart, sequence, state, class, ER), and ultra-fast rendering.\n\nUse this skill when:\n1. User asks to \"render a mermaid diagram\" or provides .mmd files\n2. User requests \"create a flowchart\u002Fsequence diagram\u002Fstate diagram\"\n3. User wants to \"apply a theme\" or \"beautify a diagram\"\n4. User needs to \"batch process multiple diagrams\"\n5. User mentions \"ASCII diagram\" or \"terminal-friendly diagram\"\n6. User wants to visualize architecture, workflows, or data models","boringman21\u002Fhyp-harness","boringman21","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F30747973?v=4","01M75MP0R5HDFAHQ3SJK3B9CNB","Nghia P","01M75MP0S5Z9KTGZ2JNXZ00YK3",4,"MIT","https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: pretty-mermaid\ndescription: |\n  Render beautiful Mermaid diagrams as SVG or ASCII art using the beautiful-mermaid library.\n  Supports 15+ themes, 5 diagram types (flowchart, sequence, state, class, ER), and ultra-fast rendering.\n\n  Use this skill when:\n  1. User asks to \"render a mermaid diagram\" or provides .mmd files\n  2. User requests \"create a flowchart\u002Fsequence diagram\u002Fstate diagram\"\n  3. User wants to \"apply a theme\" or \"beautify a diagram\"\n  4. User needs to \"batch process multiple diagrams\"\n  5. User mentions \"ASCII diagram\" or \"terminal-friendly diagram\"\n  6. User wants to visualize architecture, workflows, or data models\n---\n\n# Pretty Mermaid\n\nRender stunning, professionally-styled Mermaid diagrams with one command. Supports SVG for web\u002Fdocs and ASCII for terminals.\n\n## Quick Start\n\n### Render a Single Diagram\n\n**From a file:**\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --output diagram.svg \\\n  --format svg \\\n  --theme tokyo-night\n```\n\n**From user-provided Mermaid code:**\n1. Save the code to a `.mmd` file\n2. Run the render script with desired theme\n\n### Batch Render Multiple Diagrams\n\n```bash\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Foutput \\\n  --format svg \\\n  --theme dracula \\\n  --workers 4\n```\n\n### ASCII Output (Terminal-Friendly)\n\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --format ascii \\\n  --use-ascii\n```\n\n---\n\n## Workflow Decision Tree\n\n**Step 1: What does the user want?**\n- **Render existing Mermaid code** → Go to [Rendering](#rendering-diagrams)\n- **Create new diagram** → Go to [Creating](#creating-diagrams)\n- **Apply\u002Fchange theme** → Go to [Theming](#theming)\n- **Batch process** → Go to [Batch Rendering](#batch-rendering)\n\n**Step 2: Choose output format**\n- **SVG** (web, docs, presentations) → `--format svg`\n- **ASCII** (terminal, logs, plain text) → `--format ascii`\n\n**Step 3: Select theme**\n- **Dark mode docs** → `tokyo-night` (recommended)\n- **Light mode docs** → `github-light`\n- **Vibrant colors** → `dracula`\n- **See all themes** → Run `node scripts\u002Fthemes.mjs`\n\n---\n\n## Rendering Diagrams\n\n### From File\n\nWhen user provides a `.mmd` file or Mermaid code block:\n\n1. **Save to file** (if code block):\n   ```bash\n   cat > diagram.mmd \u003C\u003C 'EOF'\n   flowchart LR\n       A[Start] --> B[End]\n   EOF\n   ```\n\n2. **Render with theme**:\n   ```bash\n   node scripts\u002Frender.mjs \\\n     --input diagram.mmd \\\n     --output diagram.svg \\\n     --theme tokyo-night\n   ```\n\n3. **Verify output**:\n   - SVG: Open in browser or embed in docs\n   - ASCII: Display in terminal\n\n### Output Formats\n\n**SVG (Scalable Vector Graphics)**\n- Best for: Web pages, documentation, presentations\n- Features: Full color support, transparency, scalable\n- Usage: `--format svg --output diagram.svg`\n\n**ASCII (Terminal Art)**\n- Best for: Terminal output, plain text logs, README files\n- Features: Pure text, works anywhere, no dependencies\n- Usage: `--format ascii` (prints to stdout)\n- Options:\n  - `--use-ascii` - Use pure ASCII (no Unicode)\n  - `--padding-x 5` - Horizontal spacing\n  - `--padding-y 5` - Vertical spacing\n\n### Advanced Options\n\n**Custom Colors** (overrides theme):\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --bg \"#1a1b26\" \\\n  --fg \"#a9b1d6\" \\\n  --accent \"#7aa2f7\" \\\n  --output custom.svg\n```\n\n**Transparent Background**:\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --transparent \\\n  --output transparent.svg\n```\n\n**Custom Font**:\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --font \"JetBrains Mono\" \\\n  --output custom-font.svg\n```\n\n---\n\n## Creating Diagrams\n\n### Using Templates\n\n**Step 1: List available templates**\n```bash\nls assets\u002Fexample_diagrams\u002F\n# flowchart.mmd  sequence.mmd  state.mmd  class.mmd  er.mmd\n```\n\n**Step 2: Copy and modify**\n```bash\ncp assets\u002Fexample_diagrams\u002Fflowchart.mmd my-workflow.mmd\n# Edit my-workflow.mmd with user requirements\n```\n\n**Step 3: Render**\n```bash\nnode scripts\u002Frender.mjs \\\n  --input my-workflow.mmd \\\n  --output my-workflow.svg \\\n  --theme github-dark\n```\n\n### Diagram Type Reference\n\nFor detailed syntax and best practices, see [DIAGRAM_TYPES.md](references\u002FDIAGRAM_TYPES.md).\n\n**Quick reference:**\n\n**Flowchart** - Processes, workflows, decision trees\n```mermaid\nflowchart LR\n    A[Start] --> B{Decision}\n    B -->|Yes| C[Action]\n    B -->|No| D[End]\n```\n\n**Sequence** - API calls, interactions, message flows\n```mermaid\nsequenceDiagram\n    User->>Server: Request\n    Server-->>User: Response\n```\n\n**State** - Application states, lifecycle, FSM\n```mermaid\nstateDiagram-v2\n    [*] --> Idle\n    Idle --> Loading\n    Loading --> [*]\n```\n\n**Class** - Object models, architecture, relationships\n```mermaid\nclassDiagram\n    User --> Post: creates\n    Post --> Comment: has\n```\n\n**ER** - Database schema, data models\n```mermaid\nerDiagram\n    USER ||--o{ ORDER : places\n    ORDER ||--|{ ORDER_ITEM : contains\n```\n\n### From User Requirements\n\n**Step 1: Identify diagram type**\n- **Process\u002Fworkflow** → Flowchart\n- **API\u002Finteraction** → Sequence\n- **States\u002Flifecycle** → State\n- **Object model** → Class\n- **Database** → ER\n\n**Step 2: Create diagram file**\n```bash\ncat > user-diagram.mmd \u003C\u003C 'EOF'\n# [Insert generated Mermaid code]\nEOF\n```\n\n**Step 3: Render and iterate**\n```bash\nnode scripts\u002Frender.mjs \\\n  --input user-diagram.mmd \\\n  --output preview.svg \\\n  --theme tokyo-night\n\n# Review with user, edit diagram.mmd if needed, re-render\n```\n\n---\n\n## Theming\n\n### List Available Themes\n\n```bash\nnode scripts\u002Fthemes.mjs\n```\n\n**Output:**\n```\nAvailable Beautiful-Mermaid Themes:\n\n 1. zinc-light\n 2. zinc-dark\n 3. tokyo-night\n 4. tokyo-night-storm\n 5. tokyo-night-light\n 6. catppuccin-mocha\n 7. catppuccin-latte\n 8. nord\n 9. nord-light\n10. dracula\n11. github-dark\n12. github-light\n13. solarized-dark\n14. solarized-light\n15. one-dark\n\nTotal: 15 themes\n```\n\n### Theme Selection Guide\n\n**For dark mode documentation:**\n- `tokyo-night` ⭐ - Modern, developer-friendly\n- `github-dark` - Familiar GitHub style\n- `dracula` - Vibrant, high contrast\n- `nord` - Cool, minimalist\n\n**For light mode documentation:**\n- `github-light` - Clean, professional\n- `zinc-light` - High contrast, printable\n- `catppuccin-latte` - Warm, friendly\n\n**Detailed theme information:** See [THEMES.md](references\u002FTHEMES.md)\n\n### Apply Theme to Diagram\n\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --output themed.svg \\\n  --theme tokyo-night\n```\n\n### Compare Themes\n\nRender the same diagram with multiple themes:\n```bash\nfor theme in tokyo-night dracula github-dark; do\n  node scripts\u002Frender.mjs \\\n    --input diagram.mmd \\\n    --output \"diagram-${theme}.svg\" \\\n    --theme \"$theme\"\ndone\n```\n\n---\n\n## Batch Rendering\n\n### Batch Render Directory\n\n**Step 1: Organize diagrams**\n```bash\ndiagrams\u002F\n├── architecture.mmd\n├── workflow.mmd\n└── database.mmd\n```\n\n**Step 2: Batch render**\n```bash\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Frendered \\\n  --format svg \\\n  --theme tokyo-night \\\n  --workers 4\n```\n\n**Output:**\n```\nFound 3 diagram(s) to render...\n✓ architecture.mmd\n✓ workflow.mmd\n✓ database.mmd\n\n3\u002F3 diagrams rendered successfully\n```\n\n### Batch with Multiple Formats\n\nRender both SVG and ASCII:\n```bash\n# SVG for docs\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Fsvg \\\n  --format svg \\\n  --theme github-dark\n\n# ASCII for README\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Fascii \\\n  --format ascii \\\n  --use-ascii\n```\n\n### Performance Options\n\n- `--workers N` - Parallel rendering (default: 4)\n- Recommended: `--workers 8` for 10+ diagrams\n\n---\n\n## Common Use Cases\n\n### 1. Architecture Diagram for Documentation\n\n```bash\n# User provides architecture description\n# → Create flowchart.mmd\n# → Render with professional theme\n\nnode scripts\u002Frender.mjs \\\n  --input architecture.mmd \\\n  --output docs\u002Farchitecture.svg \\\n  --theme github-dark \\\n  --transparent\n```\n\n### 2. API Sequence Diagram\n\n```bash\n# User describes API flow\n# → Create sequence.mmd\n# → Render with clear theme\n\nnode scripts\u002Frender.mjs \\\n  --input api-flow.mmd \\\n  --output api-sequence.svg \\\n  --theme tokyo-night\n```\n\n### 3. Database Schema Visualization\n\n```bash\n# User provides table definitions\n# → Create er.mmd\n# → Render for database docs\n\nnode scripts\u002Frender.mjs \\\n  --input schema.mmd \\\n  --output database-schema.svg \\\n  --theme dracula\n```\n\n### 4. Terminal-Friendly Workflow\n\n```bash\n# For README or terminal display\nnode scripts\u002Frender.mjs \\\n  --input workflow.mmd \\\n  --format ascii \\\n  --use-ascii > workflow.txt\n```\n\n### 5. Presentation Slides\n\n```bash\n# High-contrast for projectors\nnode scripts\u002Frender.mjs \\\n  --input slides-diagram.mmd \\\n  --output presentation.svg \\\n  --theme zinc-light\n```\n\n---\n\n## Troubleshooting\n\n### beautiful-mermaid Not Installed\n```\nError: Cannot find module 'beautiful-mermaid'\n```\n**Note:** This should auto-install on first run. If it fails:\n```bash\ncd \u002Fpath\u002Fto\u002Fpretty-mermaid-skill && npm install\n```\n\n### Invalid Mermaid Syntax\n```\nError: Parse error on line 3\n```\n**Solution:**\n1. Validate syntax against [DIAGRAM_TYPES.md](references\u002FDIAGRAM_TYPES.md)\n2. Test on https:\u002F\u002Fmermaid.live\u002F\n3. Check for common errors:\n   - Missing spaces in `A --> B`\n   - Incorrect node shape syntax\n   - Unclosed brackets\n\n### File Not Found\n```\nError: Input file not found: diagram.mmd\n```\n**Solution:** Verify file path is correct, use absolute path if needed\n\n---\n\n## Resources\n\n### scripts\u002F\nExecutable Node.js scripts for rendering operations:\n- `render.mjs` - Main rendering script\n- `batch.mjs` - Batch processing script\n- `themes.mjs` - Theme listing utility\n\n### references\u002F\nDocumentation to inform diagram creation:\n- `THEMES.md` - Detailed theme reference with examples\n- `DIAGRAM_TYPES.md` - Comprehensive syntax guide for all diagram types\n- `api_reference.md` - beautiful-mermaid API documentation\n\n### assets\u002F\nTemplate files for quick diagram creation:\n- `example_diagrams\u002Fflowchart.mmd` - Flowchart template\n- `example_diagrams\u002Fsequence.mmd` - Sequence diagram template\n- `example_diagrams\u002Fstate.mmd` - State diagram template\n- `example_diagrams\u002Fclass.mmd` - Class diagram template\n- `example_diagrams\u002Fer.mmd` - ER diagram template\n\n---\n\n## Tips & Best Practices\n\n### Performance\n- Batch render for 3+ diagrams (parallel processing)\n- Keep diagrams under 50 nodes for fast rendering\n- Use ASCII for quick previews\n\n### Quality\n- Use `tokyo-night` or `github-dark` for technical docs\n- Add transparency for dark\u002Flight mode compatibility: `--transparent`\n- Test theme in target environment before batch rendering\n\n### Workflow\n1. Start with templates from `assets\u002Fexample_diagrams\u002F`\n2. Iterate with user feedback\n3. Apply theme last\n4. Render both SVG (docs) and ASCII (README) if needed\n\n### Accessibility\n- Use high-contrast themes for presentations\n- Add text labels to all connections\n- Avoid color-only information encoding\n","# Pretty Mermaid\n\nRender stunning, professionally-styled Mermaid diagrams with one command. Supports SVG for web\u002Fdocs and ASCII for terminals.\n\n## Quick Start\n\n### Render a Single Diagram\n\n**From a file:**\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --output diagram.svg \\\n  --format svg \\\n  --theme tokyo-night\n```\n\n**From user-provided Mermaid code:**\n1. Save the code to a `.mmd` file\n2. Run the render script with desired theme\n\n### Batch Render Multiple Diagrams\n\n```bash\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Foutput \\\n  --format svg \\\n  --theme dracula \\\n  --workers 4\n```\n\n### ASCII Output (Terminal-Friendly)\n\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --format ascii \\\n  --use-ascii\n```\n\n---\n\n## Workflow Decision Tree\n\n**Step 1: What does the user want?**\n- **Render existing Mermaid code** → Go to [Rendering](#rendering-diagrams)\n- **Create new diagram** → Go to [Creating](#creating-diagrams)\n- **Apply\u002Fchange theme** → Go to [Theming](#theming)\n- **Batch process** → Go to [Batch Rendering](#batch-rendering)\n\n**Step 2: Choose output format**\n- **SVG** (web, docs, presentations) → `--format svg`\n- **ASCII** (terminal, logs, plain text) → `--format ascii`\n\n**Step 3: Select theme**\n- **Dark mode docs** → `tokyo-night` (recommended)\n- **Light mode docs** → `github-light`\n- **Vibrant colors** → `dracula`\n- **See all themes** → Run `node scripts\u002Fthemes.mjs`\n\n---\n\n## Rendering Diagrams\n\n### From File\n\nWhen user provides a `.mmd` file or Mermaid code block:\n\n1. **Save to file** (if code block):\n   ```bash\n   cat > diagram.mmd \u003C\u003C 'EOF'\n   flowchart LR\n       A[Start] --> B[End]\n   EOF\n   ```\n\n2. **Render with theme**:\n   ```bash\n   node scripts\u002Frender.mjs \\\n     --input diagram.mmd \\\n     --output diagram.svg \\\n     --theme tokyo-night\n   ```\n\n3. **Verify output**:\n   - SVG: Open in browser or embed in docs\n   - ASCII: Display in terminal\n\n### Output Formats\n\n**SVG (Scalable Vector Graphics)**\n- Best for: Web pages, documentation, presentations\n- Features: Full color support, transparency, scalable\n- Usage: `--format svg --output diagram.svg`\n\n**ASCII (Terminal Art)**\n- Best for: Terminal output, plain text logs, README files\n- Features: Pure text, works anywhere, no dependencies\n- Usage: `--format ascii` (prints to stdout)\n- Options:\n  - `--use-ascii` - Use pure ASCII (no Unicode)\n  - `--padding-x 5` - Horizontal spacing\n  - `--padding-y 5` - Vertical spacing\n\n### Advanced Options\n\n**Custom Colors** (overrides theme):\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --bg \"#1a1b26\" \\\n  --fg \"#a9b1d6\" \\\n  --accent \"#7aa2f7\" \\\n  --output custom.svg\n```\n\n**Transparent Background**:\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --transparent \\\n  --output transparent.svg\n```\n\n**Custom Font**:\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --font \"JetBrains Mono\" \\\n  --output custom-font.svg\n```\n\n---\n\n## Creating Diagrams\n\n### Using Templates\n\n**Step 1: List available templates**\n```bash\nls assets\u002Fexample_diagrams\u002F\n# flowchart.mmd  sequence.mmd  state.mmd  class.mmd  er.mmd\n```\n\n**Step 2: Copy and modify**\n```bash\ncp assets\u002Fexample_diagrams\u002Fflowchart.mmd my-workflow.mmd\n# Edit my-workflow.mmd with user requirements\n```\n\n**Step 3: Render**\n```bash\nnode scripts\u002Frender.mjs \\\n  --input my-workflow.mmd \\\n  --output my-workflow.svg \\\n  --theme github-dark\n```\n\n### Diagram Type Reference\n\nFor detailed syntax and best practices, see [DIAGRAM_TYPES.md](references\u002FDIAGRAM_TYPES.md).\n\n**Quick reference:**\n\n**Flowchart** - Processes, workflows, decision trees\n```mermaid\nflowchart LR\n    A[Start] --> B{Decision}\n    B -->|Yes| C[Action]\n    B -->|No| D[End]\n```\n\n**Sequence** - API calls, interactions, message flows\n```mermaid\nsequenceDiagram\n    User->>Server: Request\n    Server-->>User: Response\n```\n\n**State** - Application states, lifecycle, FSM\n```mermaid\nstateDiagram-v2\n    [*] --> Idle\n    Idle --> Loading\n    Loading --> [*]\n```\n\n**Class** - Object models, architecture, relationships\n```mermaid\nclassDiagram\n    User --> Post: creates\n    Post --> Comment: has\n```\n\n**ER** - Database schema, data models\n```mermaid\nerDiagram\n    USER ||--o{ ORDER : places\n    ORDER ||--|{ ORDER_ITEM : contains\n```\n\n### From User Requirements\n\n**Step 1: Identify diagram type**\n- **Process\u002Fworkflow** → Flowchart\n- **API\u002Finteraction** → Sequence\n- **States\u002Flifecycle** → State\n- **Object model** → Class\n- **Database** → ER\n\n**Step 2: Create diagram file**\n```bash\ncat > user-diagram.mmd \u003C\u003C 'EOF'\n# [Insert generated Mermaid code]\nEOF\n```\n\n**Step 3: Render and iterate**\n```bash\nnode scripts\u002Frender.mjs \\\n  --input user-diagram.mmd \\\n  --output preview.svg \\\n  --theme tokyo-night\n\n# Review with user, edit diagram.mmd if needed, re-render\n```\n\n---\n\n## Theming\n\n### List Available Themes\n\n```bash\nnode scripts\u002Fthemes.mjs\n```\n\n**Output:**\n```\nAvailable Beautiful-Mermaid Themes:\n\n 1. zinc-light\n 2. zinc-dark\n 3. tokyo-night\n 4. tokyo-night-storm\n 5. tokyo-night-light\n 6. catppuccin-mocha\n 7. catppuccin-latte\n 8. nord\n 9. nord-light\n10. dracula\n11. github-dark\n12. github-light\n13. solarized-dark\n14. solarized-light\n15. one-dark\n\nTotal: 15 themes\n```\n\n### Theme Selection Guide\n\n**For dark mode documentation:**\n- `tokyo-night` ⭐ - Modern, developer-friendly\n- `github-dark` - Familiar GitHub style\n- `dracula` - Vibrant, high contrast\n- `nord` - Cool, minimalist\n\n**For light mode documentation:**\n- `github-light` - Clean, professional\n- `zinc-light` - High contrast, printable\n- `catppuccin-latte` - Warm, friendly\n\n**Detailed theme information:** See [THEMES.md](references\u002FTHEMES.md)\n\n### Apply Theme to Diagram\n\n```bash\nnode scripts\u002Frender.mjs \\\n  --input diagram.mmd \\\n  --output themed.svg \\\n  --theme tokyo-night\n```\n\n### Compare Themes\n\nRender the same diagram with multiple themes:\n```bash\nfor theme in tokyo-night dracula github-dark; do\n  node scripts\u002Frender.mjs \\\n    --input diagram.mmd \\\n    --output \"diagram-${theme}.svg\" \\\n    --theme \"$theme\"\ndone\n```\n\n---\n\n## Batch Rendering\n\n### Batch Render Directory\n\n**Step 1: Organize diagrams**\n```bash\ndiagrams\u002F\n├── architecture.mmd\n├── workflow.mmd\n└── database.mmd\n```\n\n**Step 2: Batch render**\n```bash\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Frendered \\\n  --format svg \\\n  --theme tokyo-night \\\n  --workers 4\n```\n\n**Output:**\n```\nFound 3 diagram(s) to render...\n✓ architecture.mmd\n✓ workflow.mmd\n✓ database.mmd\n\n3\u002F3 diagrams rendered successfully\n```\n\n### Batch with Multiple Formats\n\nRender both SVG and ASCII:\n```bash\n# SVG for docs\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Fsvg \\\n  --format svg \\\n  --theme github-dark\n\n# ASCII for README\nnode scripts\u002Fbatch.mjs \\\n  --input-dir .\u002Fdiagrams \\\n  --output-dir .\u002Fascii \\\n  --format ascii \\\n  --use-ascii\n```\n\n### Performance Options\n\n- `--workers N` - Parallel rendering (default: 4)\n- Recommended: `--workers 8` for 10+ diagrams\n\n---\n\n## Common Use Cases\n\n### 1. Architecture Diagram for Documentation\n\n```bash\n# User provides architecture description\n# → Create flowchart.mmd\n# → Render with professional theme\n\nnode scripts\u002Frender.mjs \\\n  --input architecture.mmd \\\n  --output docs\u002Farchitecture.svg \\\n  --theme github-dark \\\n  --transparent\n```\n\n### 2. API Sequence Diagram\n\n```bash\n# User describes API flow\n# → Create sequence.mmd\n# → Render with clear theme\n\nnode scripts\u002Frender.mjs \\\n  --input api-flow.mmd \\\n  --output api-sequence.svg \\\n  --theme tokyo-night\n```\n\n### 3. Database Schema Visualization\n\n```bash\n# User provides table definitions\n# → Create er.mmd\n# → Render for database docs\n\nnode scripts\u002Frender.mjs \\\n  --input schema.mmd \\\n  --output database-schema.svg \\\n  --theme dracula\n```\n\n### 4. Terminal-Friendly Workflow\n\n```bash\n# For README or terminal display\nnode scripts\u002Frender.mjs \\\n  --input workflow.mmd \\\n  --format ascii \\\n  --use-ascii > workflow.txt\n```\n\n### 5. Presentation Slides\n\n```bash\n# High-contrast for projectors\nnode scripts\u002Frender.mjs \\\n  --input slides-diagram.mmd \\\n  --output presentation.svg \\\n  --theme zinc-light\n```\n\n---\n\n## Troubleshooting\n\n### beautiful-mermaid Not Installed\n```\nError: Cannot find module 'beautiful-mermaid'\n```\n**Note:** This should auto-install on first run. If it fails:\n```bash\ncd \u002Fpath\u002Fto\u002Fpretty-mermaid-skill && npm install\n```\n\n### Invalid Mermaid Syntax\n```\nError: Parse error on line 3\n```\n**Solution:**\n1. Validate syntax against [DIAGRAM_TYPES.md](references\u002FDIAGRAM_TYPES.md)\n2. Test on https:\u002F\u002Fmermaid.live\u002F\n3. Check for common errors:\n   - Missing spaces in `A --> B`\n   - Incorrect node shape syntax\n   - Unclosed brackets\n\n### File Not Found\n```\nError: Input file not found: diagram.mmd\n```\n**Solution:** Verify file path is correct, use absolute path if needed\n\n---\n\n## Resources\n\n### scripts\u002F\nExecutable Node.js scripts for rendering operations:\n- `render.mjs` - Main rendering script\n- `batch.mjs` - Batch processing script\n- `themes.mjs` - Theme listing utility\n\n### references\u002F\nDocumentation to inform diagram creation:\n- `THEMES.md` - Detailed theme reference with examples\n- `DIAGRAM_TYPES.md` - Comprehensive syntax guide for all diagram types\n- `api_reference.md` - beautiful-mermaid API documentation\n\n### assets\u002F\nTemplate files for quick diagram creation:\n- `example_diagrams\u002Fflowchart.mmd` - Flowchart template\n- `example_diagrams\u002Fsequence.mmd` - Sequence diagram template\n- `example_diagrams\u002Fstate.mmd` - State diagram template\n- `example_diagrams\u002Fclass.mmd` - Class diagram template\n- `example_diagrams\u002Fer.mmd` - ER diagram template\n\n---\n\n## Tips & Best Practices\n\n### Performance\n- Batch render for 3+ diagrams (parallel processing)\n- Keep diagrams under 50 nodes for fast rendering\n- Use ASCII for quick previews\n\n### Quality\n- Use `tokyo-night` or `github-dark` for technical docs\n- Add transparency for dark\u002Flight mode compatibility: `--transparent`\n- Test theme in target environment before batch rendering\n\n### Workflow\n1. Start with templates from `assets\u002Fexample_diagrams\u002F`\n2. Iterate with user feedback\n3. Apply theme last\n4. Render both SVG (docs) and ASCII (README) if needed\n\n### Accessibility\n- Use high-contrast themes for presentations\n- Add text labels to all connections\n- Avoid color-only information encoding\n",{"name":5,"description":7},"main","88b355d57344f30f2c69c98db24270c91b7a427b","tools\u002Fpretty-mermaid",0,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness","https:\u002F\u002Fgithub.com\u002Fboringman21","2026-06-12 21:40:36",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add boringman21\u002Fhyp-harness --skill pretty-mermaid",{"tool":38,"command":39},"bunx","bunx skills add boringman21\u002Fhyp-harness --skill pretty-mermaid",{"tool":41,"command":42},"pnpm","pnpm dlx skills add boringman21\u002Fhyp-harness --skill pretty-mermaid","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002FSKILL.md",true,[46,52,58,62,66,70,74,78,84,88,92,96,100,104,108,114,118],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},".gitignore","OTHER","其他",570,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002F.gitignore",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"assets\u002Fexample_diagrams\u002Fclass.mmd","ASSET","资产文件",515,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fassets\u002Fexample_diagrams\u002Fclass.mmd",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"assets\u002Fexample_diagrams\u002Fer.mmd",584,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fassets\u002Fexample_diagrams\u002Fer.mmd",{"path":63,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":64,"sourceHtmlUrl":65},"assets\u002Fexample_diagrams\u002Fflowchart.mmd",253,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fassets\u002Fexample_diagrams\u002Fflowchart.mmd",{"path":67,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":68,"sourceHtmlUrl":69},"assets\u002Fexample_diagrams\u002Fsequence.mmd",295,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fassets\u002Fexample_diagrams\u002Fsequence.mmd",{"path":71,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":72,"sourceHtmlUrl":73},"assets\u002Fexample_diagrams\u002Fstate.mmd",225,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fassets\u002Fexample_diagrams\u002Fstate.mmd",{"path":75,"resourceType":75,"resourceTypeDesc":76,"sizeBytes":77,"sourceHtmlUrl":16},"LICENSE","许可证",1087,{"path":79,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":82,"sourceHtmlUrl":83},"package-lock.json","REFERENCE","参考文档",1539,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fpackage-lock.json",{"path":85,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":86,"sourceHtmlUrl":87},"package.json",313,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fpackage.json",{"path":89,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":90,"sourceHtmlUrl":91},"README_CN.md",2981,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002FREADME_CN.md",{"path":93,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":94,"sourceHtmlUrl":95},"README.md",2972,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002FREADME.md",{"path":97,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":98,"sourceHtmlUrl":99},"references\u002Fapi_reference.md",968,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Freferences\u002Fapi_reference.md",{"path":101,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":102,"sourceHtmlUrl":103},"references\u002FDIAGRAM_TYPES.md",6375,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Freferences\u002FDIAGRAM_TYPES.md",{"path":105,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":106,"sourceHtmlUrl":107},"references\u002FTHEMES.md",9117,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Freferences\u002FTHEMES.md",{"path":109,"resourceType":110,"resourceTypeDesc":111,"sizeBytes":112,"sourceHtmlUrl":113},"scripts\u002Fbatch.mjs","SCRIPT","脚本",5549,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fscripts\u002Fbatch.mjs",{"path":115,"resourceType":110,"resourceTypeDesc":111,"sizeBytes":116,"sourceHtmlUrl":117},"scripts\u002Frender.mjs",5394,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fscripts\u002Frender.mjs",{"path":119,"resourceType":110,"resourceTypeDesc":111,"sizeBytes":120,"sourceHtmlUrl":121},"scripts\u002Fthemes.mjs",1644,"https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002Ftools\u002Fpretty-mermaid\u002Fscripts\u002Fthemes.mjs",[123,130,137,142],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":20},"01M75MP8S0QC4N0ETY4V3W6HGB","hyp-harness","Multi-model fan-out harness: given a problem.yaml spec, fans out N parallel workers (kimi CLI or Claude Code CLI) each writing one research task as markdown, runs evaluator-optimizer quality gate, synthesizes all outputs into a final report, renders to dark-theme HTML. Triggers on: harness, kimi harness, claude harness, run harness, fan-out tasks, poc harness, long running task, parallel research, parallel workers, deep research.","https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fhyp-harness\u002FSKILL.md",[],[],{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":20},"01M75MP4SBQ72NCXTBN8NFNBP5","bump-version","Collect current git changes, infer the next version number, update HARNESS_VERSION in src\u002Fharness.py, and prepend a changelog entry to CHANGELOG.md. Triggers on: bump version, version bump, collect changes and version, release version, new version, up version.","https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fbump-version\u002FSKILL.md",[],[],{"skillNo":138,"name":125,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":141,"publishedAt":20},"01M75MP3K8EKFXPWDY3A7T554B","https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fhyp-harness\u002FSKILL.md",[],[],{"skillNo":143,"name":132,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":144,"categories":145,"keywords":146,"publishedAt":20},"01M75MP2KV3PB8Y0ZEPQ6HRH9S","https:\u002F\u002Fgithub.com\u002Fboringman21\u002Fhyp-harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fbump-version\u002FSKILL.md",[],[]]