Ask your AI to make the first diagram.

The free SimpleDiagrams skills let Claude Code, Codex and compatible agents create a diagram or a new sketch-style shape that you can open and keep editing on your Mac.

Free and open source. Diagrams from the skill open in SimpleDiagrams 5.4 or later on your Mac.

Order to delivery Built by the diagram skill
A BPMN order-to-delivery process with a customer pool and a web shop pool in sales, finance and warehouse lanes: the order arrives as a message, a gateway sends a back-order notice when it is out of stock, and otherwise stock is reserved, payment and packing run in parallel, and the shipped order sends the customer a delivery notice.

How it works

Install the diagram skill once, then describe what you need. Your agent builds an ordinary SimpleDiagrams document, not a flattened picture.

  1. Install the diagram skill

    In Claude Code, run these two commands in your terminal:

    In Codex, paste this into a chat, and restart Codex if the skill does not appear:

  2. Describe what you need

    Name the kind of diagram if you have one in mind, or let the agent choose. It can draw from a README, a folder of code or a photo of a whiteboard.

    “Draw how a customer order moves through our web shop, order service, payments and warehouse.”
  3. Open it in SimpleDiagrams

    Open the result in SimpleDiagrams, rearrange it, change the labels, or add your own shapes.

What you can ask for

The diagram skill uses the shapes built into SimpleDiagrams, BPMN and UML included, and the shapes the app draws itself.

Flowcharts

“Turn this procedure into a flowchart.”

BPMN

“Model this approval process in BPMN, with a lane for each team.”

UML class diagrams

“Draw a UML class diagram of the models in this folder.”

UML sequence diagrams

“Draw a UML sequence diagram of how a login request travels through these services.”

Database diagrams

“Draw these database tables and the relationships between their fields.”

Architecture

“Diagram the architecture described in this repository’s README.”

Gantt charts

“Draw a Gantt chart of this project plan, with its milestones.”

Org charts

“Make an org chart for this team.”

Whiteboard photos

“Redraw this whiteboard photo as a diagram.”

Create a shape

When a domain needs a symbol the app does not have, ask an agent to create a sketch-style SVG shape for it.

“Make a flat hand-drawn bicycle as an editable SimpleDiagrams SVG.”

Drag the SVG onto a diagram and choose Convert to Editable Shape, then change its fill and line colours like any other shape.

Get the shape skill on GitHub
A written request and the sketch-style shape it produced.

Good to know

  • Both skills are free and open source under the MIT licence.
  • The skills’ own scripts make no network request and store nothing between runs. Your AI service handles your files under its own policies.
  • The diagram skill writes new documents and never replaces one you already have.
  • It writes SimpleDiagrams documents only. A BPMN diagram it draws is not a .bpmn file or a process an engine can run.

Download SimpleDiagrams 5 and try it free for 7 days

The free trial is in the download from this site. The Mac App Store edition is paid up front and has no trial.

One licence covers one person on every Mac they use.