iot logo

iot

iot

markdown-viewer/skills1.9Kinstalls2.9Kstars

SKILL.md

Full skill instructions

IoT Architecture Diagram Generator

Quick Start: Select device/sensor icons → Place edge gateways → Connect to cloud services → Group into zones → Wrap in ```plantuml fence.

⚠️ IMPORTANT: Always use ```plantuml or ```puml code fence. NEVER use ```text — it will NOT render as a diagram.

Critical Rules

  • Every diagram starts with @startuml and ends with @enduml
  • Use left to right direction for typical IoT data flows (Device → Edge → Cloud)
  • Use mxgraph.aws4.* stencil syntax for IoT service and device icons
  • Default colors are applied automatically — you do NOT need to specify fillColor or strokeColor
  • Use rectangle "Zone" { ... } or package "Site" { ... } for grouping
  • Directed flows use -->, async/event-driven flows use ..> (dashed)

Full stencil reference: See stencils/README.md for 9500+ available icons.

Mxgraph Stencil Syntax

mxgraph.aws4.<icon> "Label" as <alias>

Core IoT Stencils

CategoryStencilsPurpose
IoT Platformiot_core, internet_of_things, iot_1clickCentral IoT hub / message broker
Edge/Gatewaygreengrass, iot_device_gateway, freertos, iot_expresslinkEdge computing & device gateway
Greengrassiot_greengrass_component, iot_greengrass_nucleus, iot_greengrass_stream_managerEdge runtime components
Device Mgmtiot_device_management, iot_device_defender, iot_device_tester, iot_over_the_air_updateFleet provisioning, security, OTA
Analyticsiot_analytics, iot_analytics_channel, iot_analytics_pipeline, iot_analytics_dataset, iot_analytics_data_storeIoT data processing pipeline
Events/Rulesiot_events, iot_device_defender_iot_device_jobsEvent detection & job execution
Digital Twiniot_twinmaker, iot_sitewise, iot_sitewise_asset, iot_sitewise_asset_modelAsset modeling & visualization
Fleetiot_fleetwise, iot_device_management_fleetVehicle & device fleet telemetry

Device & Sensor Stencils

CategoryStencils
Sensorssensor, iot_thing_temperature_sensor, iot_thing_humidity_sensor, iot_thing_vibration_sensor, iot_thing_temperature_humidity_sensor, iot_thing_temperature_vibration_sensor
Actuatorsactuator, iot_thing_relay, iot_thing_stacklight
Industrialfactory, iot_thing_industrial_pc, iot_thing_plc
Smart Homethermostat, alexa_enabled_device, alexa_smart_home_skill, camera, camera2
Protocolsmqtt_protocol, iot_lorawan_protocol, iot_greengrass_protocol
Boats/Vehiclesiot_sailboat, iot_fleetwise
Roboticsrobomaker, iot_roborunner

Connection Types

SyntaxMeaningUse Case
A --> BSolid arrowSync API / data flow
A ..> BDashed arrowAsync telemetry / MQTT publish
A -- BSolid linePhysical / bidirectional link
A --> B : "label"Labeled connectionDescribe protocol or data

Quick Example

@startuml
left to right direction
rectangle "Factory Floor" {
  mxgraph.aws4.sensor "Temp\nSensor" as s1
  mxgraph.aws4.iot_thing_plc "PLC" as plc
}
mxgraph.aws4.greengrass "Greengrass\nEdge" as gg
mxgraph.aws4.iot_core "IoT Core" as core
mxgraph.aws4.iot_analytics "IoT\nAnalytics" as analytics

s1 --> gg : MQTT
plc --> gg
gg --> core
core --> analytics
@enduml

IoT Architecture Types

TypePurposeKey StencilsExample
Smart FactoryIndustrial IoT monitoringsensor, iot_thing_plc, greengrass, iot_sitewisesmart-factory.md
Smart HomeHome automationthermostat, alexa_enabled_device, camera, iot_coresmart-home.md
Fleet TelemetryVehicle fleet trackingiot_fleetwise, iot_core, iot_analyticsfleet-telemetry.md
Edge ComputingLocal processing at edgegreengrass, freertos, iot_greengrass_componentedge-computing.md
Digital TwinAsset modeling & simulationiot_twinmaker, iot_sitewise_asset_model, iot_sitewisedigital-twin.md
Sensor NetworkDistributed sensor meshsensor, iot_lorawan_protocol, iot_device_gatewaysensor-network.md
Device ManagementFleet provisioning & OTAiot_device_management, iot_device_defender, iot_over_the_air_updatedevice-management.md
RoboticsRobot fleet orchestrationrobomaker, iot_roborunner, greengrassrobotics.md