{ "schemaVersion": "1.0", "item": { "slug": "mermaid", "name": "Mermaid Diagrams", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/jarekbird/mermaid", "canonicalUrl": "https://clawhub.ai/jarekbird/mermaid", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/mermaid", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mermaid", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "generate-test.sh", "package.json" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/mermaid" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/mermaid", "agentPageUrl": "https://openagent3.xyz/skills/mermaid/agent", "manifestUrl": "https://openagent3.xyz/skills/mermaid/agent.json", "briefUrl": "https://openagent3.xyz/skills/mermaid/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Mermaid Diagrams Skill", "body": "Generate diagrams from text using Mermaid." }, { "title": "Requirements", "body": "@mermaid-js/mermaid-cli (npm install -g @mermaid-js/mermaid-cli)" }, { "title": "Usage", "body": "Write Mermaid syntax to a .mmd file\nRun mmdc to render PNG/SVG\nReturn the image to the user" }, { "title": "Basic Command", "body": "mmdc -i input.mmd -o output.png -t dark -b transparent" }, { "title": "Options", "body": "FlagDescription-iInput .mmd file-oOutput file (.png, .svg, .pdf)-tTheme: default, dark, forest, neutral-bBackground color (transparent, hex)-wWidth in pixels (default: 800)-HHeight in pixels-sScale factor (default: 1, use 2-3 for high-res)-cConfig JSON file for advanced theming" }, { "title": "Supported Diagram Types", "body": "Flowchart: graph TD / graph LR\nSequence: sequenceDiagram\nClass: classDiagram\nState: stateDiagram-v2\nER: erDiagram\nGantt: gantt\nPie: pie\nMindmap: mindmap\nTimeline: timeline\nGit graph: gitGraph\nQuadrant: quadrantChart\nBlock: block-beta" }, { "title": "Workflow", "body": "Determine the best diagram type for what the user wants\nWrite the .mmd file to /tmp/mermaid-.mmd\nRender: mmdc -i /tmp/mermaid-.mmd -o /tmp/mermaid-.png -t dark -b transparent -s 2\nShow the image to the user via Read tool\nClean up temp files if not needed" }, { "title": "Example: Architecture Diagram", "body": "graph TD\n A[Client] -->|HTTPS| B[API Gateway]\n B --> C[Auth Service]\n B --> D[App Server]\n D --> E[(PostgreSQL)]\n D --> F[(Redis Cache)]" }, { "title": "Example: Sequence Diagram", "body": "sequenceDiagram\n participant U as User\n participant A as API\n participant DB as Database\n U->>A: POST /login\n A->>DB: Validate credentials\n DB-->>A: User record\n A-->>U: JWT token" }, { "title": "Tips", "body": "Use graph LR for left-to-right flow, graph TD for top-down\nKeep node labels short — detail goes in tooltips or notes\nUse subgraphs to group related components\nFor dark backgrounds, use -t dark -b transparent\nScale -s 2 or -s 3 for sharp images on retina displays\nAlways use pty: false when calling mmdc" }, { "title": "Theming", "body": "For custom colors, create a config JSON:\n\n{\n \"theme\": \"base\",\n \"themeVariables\": {\n \"primaryColor\": \"#f59e0b\",\n \"primaryTextColor\": \"#1a1a1a\",\n \"primaryBorderColor\": \"#d97706\",\n \"lineColor\": \"#6b7280\",\n \"secondaryColor\": \"#10b981\",\n \"tertiaryColor\": \"#3b82f6\"\n }\n}\n\nThen: mmdc -i input.mmd -o output.png -c config.json" } ], "body": "Mermaid Diagrams Skill\n\nGenerate diagrams from text using Mermaid.\n\nRequirements\n@mermaid-js/mermaid-cli (npm install -g @mermaid-js/mermaid-cli)\nUsage\nWrite Mermaid syntax to a .mmd file\nRun mmdc to render PNG/SVG\nReturn the image to the user\nBasic Command\nmmdc -i input.mmd -o output.png -t dark -b transparent\n\nOptions\nFlag\tDescription\n-i\tInput .mmd file\n-o\tOutput file (.png, .svg, .pdf)\n-t\tTheme: default, dark, forest, neutral\n-b\tBackground color (transparent, hex)\n-w\tWidth in pixels (default: 800)\n-H\tHeight in pixels\n-s\tScale factor (default: 1, use 2-3 for high-res)\n-c\tConfig JSON file for advanced theming\nSupported Diagram Types\nFlowchart: graph TD / graph LR\nSequence: sequenceDiagram\nClass: classDiagram\nState: stateDiagram-v2\nER: erDiagram\nGantt: gantt\nPie: pie\nMindmap: mindmap\nTimeline: timeline\nGit graph: gitGraph\nQuadrant: quadrantChart\nBlock: block-beta\nWorkflow\nDetermine the best diagram type for what the user wants\nWrite the .mmd file to /tmp/mermaid-.mmd\nRender: mmdc -i /tmp/mermaid-.mmd -o /tmp/mermaid-.png -t dark -b transparent -s 2\nShow the image to the user via Read tool\nClean up temp files if not needed\nExample: Architecture Diagram\ngraph TD\n A[Client] -->|HTTPS| B[API Gateway]\n B --> C[Auth Service]\n B --> D[App Server]\n D --> E[(PostgreSQL)]\n D --> F[(Redis Cache)]\n\nExample: Sequence Diagram\nsequenceDiagram\n participant U as User\n participant A as API\n participant DB as Database\n U->>A: POST /login\n A->>DB: Validate credentials\n DB-->>A: User record\n A-->>U: JWT token\n\nTips\nUse graph LR for left-to-right flow, graph TD for top-down\nKeep node labels short — detail goes in tooltips or notes\nUse subgraphs to group related components\nFor dark backgrounds, use -t dark -b transparent\nScale -s 2 or -s 3 for sharp images on retina displays\nAlways use pty: false when calling mmdc\nTheming\n\nFor custom colors, create a config JSON:\n\n{\n \"theme\": \"base\",\n \"themeVariables\": {\n \"primaryColor\": \"#f59e0b\",\n \"primaryTextColor\": \"#1a1a1a\",\n \"primaryBorderColor\": \"#d97706\",\n \"lineColor\": \"#6b7280\",\n \"secondaryColor\": \"#10b981\",\n \"tertiaryColor\": \"#3b82f6\"\n }\n}\n\n\nThen: mmdc -i input.mmd -o output.png -c config.json" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/jarekbird/mermaid", "publisherUrl": "https://clawhub.ai/jarekbird/mermaid", "owner": "jarekbird", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/mermaid", "downloadUrl": "https://openagent3.xyz/downloads/mermaid", "agentUrl": "https://openagent3.xyz/skills/mermaid/agent", "manifestUrl": "https://openagent3.xyz/skills/mermaid/agent.json", "briefUrl": "https://openagent3.xyz/skills/mermaid/agent.md" } }