← Back to Skills Marketplace
Mermaid Architect
by
azzar budiyanto
· GitHub ↗
· v1.0.0
2082
Downloads
0
Stars
11
Active Installs
1
Versions
Install in OpenClaw
/install mermaid-architect
Description
Generate beautiful, hand-drawn Mermaid diagrams with robust syntax (quoted labels, ELK layout). Use this skill when the user asks for "diagram", "flowchart", "sequence diagram", or "visualize this process".
README (SKILL.md)
Mermaid Architect
Usage
- Role: Diagram Architect & Designer.
- Trigger: "Draw this", "Make a diagram", "Visualize".
- Output: Mermaid code block (
mermaid) + Explanation.
Capabilities
- Flowcharts: Process mapping, decision trees.
- Sequence Diagrams: API calls, user interactions.
- Class Diagrams: OOP structures, database schemas.
- State Diagrams: Lifecycle management.
Guidelines
- Always use quoted strings for node labels when they contain parentheses, commas, or colons.
- Use safe node IDs: no spaces; use camelCase, PascalCase, or underscores. Avoid reserved IDs:
end,subgraph,graph,flowchart. - Prefer
TD(Top-Down) for hierarchies,LR(Left-Right) for timelines. - Use
subgraph id [Label]with an explicit ID and label (no spaces in ID). - See references/syntax-guide.md for full safe-syntax rules.
Reference Materials
Validation
Run the validator on one or more .mmd files:
scripts/validate-mmd assets/examples/*.mmd
Usage Guidance
This skill is coherent and low-risk: it only contains Mermaid syntax rules and examples and asks for nothing sensitive. Before installing or using it, note that SKILL.md references a validator script and example assets that are not bundled — if you expect those to run, request the missing scripts/assets or provide your own validator. As usual, review any generated Mermaid text before rendering in a web context and avoid pasting sensitive data into diagrams.
Capability Analysis
Type: OpenClaw Skill
Name: mermaid-architect
Version: 1.0.0
The skill bundle is designed to generate Mermaid diagrams, and all analyzed files (metadata, skill instructions, syntax guide) align with this stated purpose. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the AI agent. The `SKILL.md` file includes a `bash` command for validation, but it is presented as an instruction for a human user/developer to run, not as a command for the AI agent to execute as part of its core function, and therefore does not indicate malicious intent or a vulnerability in the agent's operational flow.
Capability Assessment
Purpose & Capability
Name/description (Mermaid diagram generation) align with the provided instructions and reference material: the files only contain Mermaid syntax guidance and diagram-generation rules. There are no unrelated environment variables, binaries, or network endpoints requested.
Instruction Scope
The SKILL.md stays within diagram-generation scope (rules for node IDs, quoted labels, layout, and examples). It does reference running a local validator ('scripts/validate-mmd') and several example asset paths ('assets/examples/*.mmd' and assets/examples/* .mmd) that are not included in the manifest; this is an inconsistency (missing helper script/assets) but not an obvious security issue. The instructions do not direct the agent to read user secrets, system config, or external endpoints.
Install Mechanism
No install spec or code is provided (instruction-only), so nothing is downloaded or written to disk by the skill itself — lowest-risk install profile.
Credentials
The skill declares no required environment variables, credentials, or config paths. The instructions do not reference any hidden env vars or external credentials.
Persistence & Privilege
The skill does not request always:true and uses default invocation settings. Autonomous invocation is allowed (platform default) but there is no indication this skill needs persistent privileges or system-wide configuration changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mermaid-architect - After installation, invoke the skill by name or use
/mermaid-architect - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of mermaid-architect.
- Generate hand-drawn style Mermaid diagrams with enhanced syntax features (quoted labels, ELK layout).
- Supports flowcharts, sequence, class, and state diagrams.
- Provides strict syntax guidelines for node labels, IDs, direction, and subgraphs.
- Includes reference guides, example diagrams, and a syntax validator script.
Metadata
Frequently Asked Questions
What is Mermaid Architect?
Generate beautiful, hand-drawn Mermaid diagrams with robust syntax (quoted labels, ELK layout). Use this skill when the user asks for "diagram", "flowchart", "sequence diagram", or "visualize this process". It is an AI Agent Skill for Claude Code / OpenClaw, with 2082 downloads so far.
How do I install Mermaid Architect?
Run "/install mermaid-architect" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mermaid Architect free?
Yes, Mermaid Architect is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Mermaid Architect support?
Mermaid Architect is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mermaid Architect?
It is built and maintained by azzar budiyanto (@1999azzar); the current version is v1.0.0.
More Skills