agent-transcript

Full Documentation of OpenClaw diagram-maker Skill

Path: openclaw/tree/main/skills/diagram-maker This is an official built-in automated diagram generation agent skill for OpenClaw. Its core capability is converting natural language, source code or documents into professional drawing syntax and rendered visual charts with one click. The agent invokes this skill automatically throughout workflows, requiring no manual writing of Mermaid or PlantUML code.

1. Core Workflow

1. Semantic Parsing Accepts three types of input: natural language descriptions, business documents, and repository code structures / interface logic. The LLM automatically extracts nodes, dependencies, processes and hierarchical relationships.
2. Standard Drawing Syntax Generation Outputs mainstream markup languages for diagramming: Mermaid (default), PlantUML and Graphviz DOT.
3. Rendering & Export Automatically renders diagrams into SVG or PNG files saved to local output directories. It also returns copyable source code compatible with Typora, GitBook, Excalidraw and ProcessOn.
4. Iterative Optimization Supports conversational revisions, including layout adjustments, additional layers, module supplements and diagram type switching, without rewriting full logic descriptions.

2. Supported Diagram Types (Covers Technical & Business Scenarios)

Technical Development Diagrams

• System architecture diagrams, microservice topologies, C4 layered architecture
• UML diagrams: sequence diagrams, class diagrams, use case diagrams, state machines
• Database ER (Entity-Relationship) diagrams
• Interface call chains, request flowcharts, deployment topologies
• Project directory trees, code dependency graphs

Business Process Diagrams

• Business flowcharts, approval workflows, user operation paths
• Swimlane diagrams (BPMN), state transition diagrams
• Gantt charts for project schedules and iteration plans
• Mind maps, knowledge graphs, technical learning roadmaps

Data & Reporting Diagrams

• Pie charts, bar charts, funnels, timelines
• Comparison matrices, module relationship diagrams, organizational charts

3. Key Feature Highlights

1. Automated Repository Code Visualization When paired with the github and code-analyze skills, it scans full project source code to auto-generate system architecture, module dependency and database ER diagrams, eliminating manual structural sorting for new project maintainers.
2. PR & Document Linked Auto-Insertion of Diagrams Works alongside the autoreview code review skill: it auto-generates call chain and logic flow diagrams during code reviews and embeds them into PR comments to visualize execution paths of problematic code.
3. Transparent Auto-Trigger The agent activates diagram-maker automatically when it detects drawing, architecture sorting or process organization requirements, with no manual command invocation needed.
4. Complete Document Output Produces bundled deliverables including Markdown documents, raw diagram syntax and image files, ready for direct integration into project READMEs, technical proposals and API documentation.
5. Lightweight with Zero Extra Dependencies Comes with a built-in Mermaid rendering engine; no local diagram software installation required, fully compatible with Linux, macOS and Windows.

4. Typical Use Cases

1. Technical proposal drafting: Generate layered architecture diagrams from a single sentence describing microservice structures
2. Code review assistance: Create sequence diagrams for complex interface calls to assist logic defect troubleshooting
3. Project documentation maintenance: Auto-generate ER and module dependency graphs from source code to update README files
4. Business requirement sorting: Convert lengthy requirement documents into standardized business flowcharts
5. Project management: Build iteration Gantt charts and task dependency mind maps

5. Differentiation from Peer Diagramming Skills

1. diagram-maker (Official Built-in): Out-of-the-box integration with OpenClaw’s code, PR and file reading capabilities, optimized for automated diagramming across full software development lifecycles.
2. Third-party excalidraw-diagram: Only outputs Excalidraw JSON files that require manual import into the web viewer.
3. chartgen: Focuses exclusively on statistical data charts (bar, pie) and does not support architecture, sequence or flow diagrams.

6. Prerequisite Dependencies

Basic file reading and code parsing OpenClaw skills must be enabled. To auto-generate architecture diagrams by scanning GitHub repositories, the github skill is additionally required.