graphviz-convert-image

Convert an image of a graph into a Graphviz Dot in an accurate way

SKILL.md

GitHub

Goal

  • Given an input image of a graph, convert it into a Graphviz DOT file that matches it exactly

Workflow

Create the Graphviz File

  • Create a DOT file that matches the figure exactly
  • Save the result in graph.dot
  • Say in the DOT file how it was generated, with this comment at the top:
    // Generated by `.claude/skills/graphviz.convert_image/SKILL.md`
    

Render to Image

  • Generate an image from the graph description:
    > dot -Tpng graph.dot -o graph.png
    > open graph.png
    

Compare and Refine

  • If graph.png differs from the input image:
    • Find the differences in layout, e.g.,
      • Node positions
      • Node colors
    • Apply changes to graph.dot to approximate the input image, e.g.,
      • Use rank to keep the nodes in the same relative position
      • Change node colors to match the input image

Verification

  • Confirm graph.dot renders without errors
  • Confirm graph.png matches the input image in node positions and colors
  • The DOT file says that it was generated by .claude/skills/graphviz.convert_image/SKILL.md