Manually Dragging Boxes for Architecture Diagrams Is Finally Dead

By: Charly Wargnier

MANUALLY DRAGGING BOXES FOR ARCHITECTURE DIAGRAMS IS FINALLY DEAD

There is a new open-source agent skill that turns raw codebases into cleanly routed draw.io diagrams without you placing a single coordinate.

The project, drawio-skill, runs directly inside Claude Code, Cursor, or Copilot. Instead of opening a blank canvas, you just ask your agent to map the repo.

What it does

  • Extracts the module structure (supports Python, JS/TS, Go, Rust)
  • Uses Graphviz for auto-layout and routing
  • Drops redundant edges so the graph stays readable
  • Builds native, editable draw.io files

The standout feature is visual self-checking: once it generates the diagram, the agent “looks” at the resulting PNG. If it sees stacked edges or clipped text, it auto-fixes the layout across up to 5 iterative rounds.

It runs from a single file — no MCP server, no background daemon. It’s 100% free and open-source.

Key Points

  • Auto-generates draw.io architecture diagrams from a codebase via an agent skill
  • Supports Python, JS/TS, Go, and Rust, using Graphviz for routing
  • Self-corrects its own layout by visually inspecting the rendered PNG (up to 5 rounds)
  • Single-file, no MCP server or background daemon, free and open-source