excalidraw-diagram

The excalidraw-diagram skill provides a robust interface for creating and rendering technical diagrams, architecture models, and conceptual illustrations. It is specifically optimized for engineers, system architects, and technical writers who need to automate the visualization of complex workflows, data structures, or infrastructure layouts. By utilizing the excalidraw.py engine, users can programmatically define elements in JSON format and convert them into clean, high-quality PNG or SVG outputs. This tool is ideal for documenting system designs, creating sequence diagrams, or outlining technical specifications that require consistent visual standards.

• Generates complex visual diagrams using the Excalidraw JSON specification.

• Supports rendering of standard shapes including rectangles, ellipses, diamonds, lines, arrows, and custom text elements.

• Enables batch processing to generate multiple diagrams simultaneously for documentation reports.

• Includes a specialized color palette tailored for technical domains like compute, memory, tensor operations, and CUDA core architectures.

• Offers precise control over styling, including stroke colors, fill styles, font families (with monospace support), and roughness settings for professional, crisp technical output.

• Users should define diagrams using the Excalidraw JSON structure, ensuring the use of fontFamily 5 for monospace text and roughness 0 for clean lines.

• Always use separate text elements inside boxes to ensure reliable rendering and correct alignment.

• Ensure arrows point perpendicularly to target objects and avoid overlapping text with connectors for optimal readability.

• Input files must be valid JSON following the Excalidraw v2 specification, while the output is rendered as standard raster or vector image files.

• The tool is best suited for scenarios where visual documentation needs to be version-controlled or generated automatically as part of a CI/CD pipeline.

• Be aware that unsupported element types will cause an explicit failure during the rendering process, so validate your JSON schema before execution.