giuseppe-trisciuoglio/developer-kit / plugins/developer-kit-core/skills/drawio-logical-diagrams
drawio-logical-diagrams
VerifiedCreates professional logical flow diagrams and logical system architecture diagrams using draw.io XML format (.drawio files). Use when creating: (1) logical flow diagrams showing data/process flow between system components, (2) logical architecture diagrams representing system structure without cloud provider specifics, (3) BPMN process diagrams, (4) UML diagrams (class, sequence, activity), (5) data flow diagrams (DFD), (6) decision flowcharts, or (7) system interaction diagrams. This skill focuses on generic/abstract representations, not AWS/Azure-specific architectures (use aws-drawio-architecture-diagrams for cloud diagrams).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.1 KB |
| references/color-palette.md | markdown | 1.4 KB |
| references/constraints-warnings.md | markdown | 5.8 KB |
| references/diagram-templates.md | markdown | 26.4 KB |
| references/diagram-types-detailed.md | markdown | 5.3 KB |
| references/layout-best-practices.md | markdown | 4.6 KB |
| references/shape-examples.md | markdown | 5.0 KB |
| references/shape-styles.md | markdown | 7.8 KB |
references/shape-styles.md
View on GitHub# Shape Styles Reference
Complete reference for draw.io shapes and styles used in logical diagrams.
## Basic Shapes
### Rectangle
```xml
style="rounded=0;whiteSpace=wrap;html=1;"
```
### Rounded Rectangle
```xml
style="rounded=1;whiteSpace=wrap;html=1;"
```
### Ellipse (Circle/Oval)
```xml
style="ellipse;whiteSpace=wrap;html=1;"
```
### Diamond (Rhombus)
```xml
style="rhombus;whiteSpace=wrap;html=1;"
```
### Cylinder (Database)
```xml
style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;"
```
### Hexagon
```xml
style="shape=hexagon;perimeter=hexagonPerimeter2;whiteSpace=wrap;html=1;"
```
### Parallelogram
```xml
style="shape=ext;double=1;rounded=0;whiteSpace=wrap;html=1;"
```
### Cloud (External System)
```xml
style="shape=cloud;whiteSpace=wrap;html=1;"
```
### Folder
```xml
style="shape=folder;whiteSpace=wrap;html=1;"
```
## Style Properties
### Fill Colors
| Color Name | Hex Code | Usage |
|------------|----------|-------|
| Light Blue | `#dae8fc` | Process/Service |
| Light Yellow | `#fff2cc` | Decision/Gateway |
| Light Green | `#d5e8d4` | Start/End/Success |
| Light Cyan | `#e1f5fe` | Data Store |
| Light Purple | `#f3e5f5` | External System |
| Light Red | `#f8cecc` | Error/Stop |
| Light Orange | `#ffe0b2` | Actor/User |
| Light Gray | `#f5f5f5` | Container |
### Border Colors
| Color Name | Hex Code | Usage |
|------------|----------|-------|
| Blue | `#6c8ebf` | Process border |
| Yellow | `#d6b656` | Decision border |
| Green | `#82b366` | Start/End border |
| Cyan | `#0277bd` | Data store border |
| Purple | `#7b1fa2` | External system border |
| Red | `#b85450` | Error/Stop border |
| Orange | `#f57c00` | Actor border |
| Gray | `#666666` | Container border |
### Font Settings
```xml
fontFamily=Segoe UI
fontSize=10-14
fontColor=#333333
fontStyle=0 (normal), 1 (bold), 2 (italic)
```
## Complete Shape Examples
### Process Box
```xml
<mxCell id="2" value="Process Name"
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="200" y="100" width="120" height="60" as="geometry" />
</mxCell>
```
### Decision Diamond
```xml
<mxCell id="3" value="Decision?"
style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="280" y="200" width="80" height="80" as="geometry" />
</mxCell>
```
### Start/End Oval
```xml
<mxCell id="4" value="Start"
style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="200" y="300" width="80" height="40" as="geometry" />
</mxCell>
```
### Data Store (Cylinder)
```xml
<mxCell id="5" value="Database"
style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;fillColor=#e1f5fe;strokeColor=#0277bd;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="400" y="100" width="60" height="80" as="geometry" />
</mxCell>
```
### External System (Cloud)
```xml
<mxCell id="6" value="External API"
style="shape=cloud;whiteSpace=wrap;html=1;fillColor=#f3e5f5;strokeColor=#7b1fa2;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="400" y="100" width="100" height="60" as="geometry" />
</mxCell>
```
### Actor/User
```xml
<mxCell id="7" value="User"
style="ellipse;whiteSpace=wrap;html=1;fillColor=#ffe0b2;strokeColor=#f57c00;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="50" y="200" width="60" height="40" as="geometry" />
</mxCell>
```
### Error State
```xml
<mxCell id="8" value="Error"
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;fontFamily=Segoe UI;"
vertex="1" parent="1">
<mxGeometry x="300" y="200" width="100" height="50" as="geometry" />
</mxCell>
```
## Connector Styles
### Standard Arrow
```xml
style="edgeStyle=orthogonalEdgeStyle;rounded=0;endArrow=classic;endFill=1;strokeColor=#666666;strokeWidth=2;"
```
### Dashed Arrow
```xml
style="edgeStyle=orthogonalEdgeStyle;rounded=0;dashed=1;dashPattern=5 5;endArrow=classic;endFill=1;strokeColor=#666666;strokeWidth=2;"
```
### Open Arrow
```xml
style="edgeStyle=orthogonalEdgeStyle;rounded=0;endArrow=open;endFill=0;strokeColor=#666666;strokeWidth=2;"
```
### Block Arrow
```xml
style="edgeStyle=orthogonalEdgeStyle;rounded=0;endArrow=blockThin;endFill=1;strokeColor=#666666;strokeWidth=2;"
```
### Curved Arrow
```xml
style="edgeStyle=curvedEdgeStyle;rounded=0;endArrow=classic;endFill=1;strokeColor=#666666;strokeWidth=2;"
```
### Edge with Label
```xml
<mxCell id="10" value="Label"
style="text;html=1;align=center;verticalAlign=middle;fontSize=11;fontColor=#333333;labelBackgroundColor=#ffffff;"
vertex="1" parent="1">
<mxGeometry x="250" y="160" width="40" height="20" as="geometry" />
</mxCell>
```
## Container Styles
### Simple Container
```xml
<mxCell id="20" value="Container Name"
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;fontSize=14;fontStyle=1;"
vertex="1" parent="1">
<mxGeometry x="100" y="50" width="400" height="300" as="geometry" />
</mxCell>
```
### Dashed Container (Boundary)
```xml
<mxCell id="21" value="Boundary"
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;dashed=1;dashPattern=8 4;fontSize=14;fontStyle=1;"
vertex="1" parent="1">
<mxGeometry x="100" y="50" width="400" height="300" as="geometry" />
</mxCell>
```
## Child Elements in Containers
When placing elements inside a container, reference the container ID in the `parent` attribute:
```xml
<!-- Container -->
<mxCell id="20" value="Layer"
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;"
vertex="1" parent="1">
<mxGeometry x="100" y="50" width="400" height="300" as="geometry" />
</mxCell>
<!-- Child element inside container -->
<mxCell id="21" value="Service"
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;"
vertex="1" parent="20">
<mxGeometry x="20" y="30" width="100" height="50" as="geometry" />
</mxCell>
```
## Special Characters
| Character | Entity |
|-----------|--------|
| `<` | `<` |
| `>` | `>` |
| `&` | `&` |
| Line break | `
` or `<br>` with html=1 |
## Shape Examples
### Process Box
```xml
<mxCell id="2" value="Process Name" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;" vertex="1" parent="1"><mxGeometry x="200" y="100" width="120" height="60" as="geometry"/></mxCell>
```
### Decision Diamond
```xml
<mxCell id="3" value="Decision?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=12;" vertex="1" parent="1"><mxGeometry x="280" y="200" width="80" height="80" as="geometry"/></mxCell>
```
### Start/End Oval
```xml
<mxCell id="4" value="Start" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;" vertex="1" parent="1"><mxGeometry x="200" y="300" width="80" height="40" as="geometry"/></mxCell>
```
### Data Store (Cylinder)
```xml
<mxCell id="5" value="Database" style="shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;fillColor=#e1f5fe;strokeColor=#0277bd;fontSize=12;" vertex="1" parent="1"><mxGeometry x="400" y="100" width="60" height="80" as="geometry"/></mxCell>
```
### Connector/Arrow
```xml
<mxCell id="10" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=classic;endFill=1;strokeColor=#666666;strokeWidth=2;" edge="1" parent="1" source="2" target="3"><mxGeometry relative="1" as="geometry"/></mxCell>
```
## Coordinate Guidelines
### Element Sizes
| Element Type | Width | Height |
|-------------|-------|--------|
| Process Box | 100-150 | 50-70 |
| Decision Diamond | 70-100 | 70-100 |
| Start/End | 70-100 | 35-50 |
| Data Store | 50-70 | 70-90 |
| Actor | 50-70 | 40-50 |
### Spacing
- Between elements: 40-60px
- Inside containers: 15-25px
- Connector to element: 10-15px
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |