skilld
All skills
cmb211087 avatar

/azure-diagrams

@ce0fc67
by cmb211087cmb211087/azure-diagrams-skill149 stars
39

Comprehensive technical diagramming toolkit for solutions architects, presales, and developers. Creates Azure architecture diagrams (800+ Azure service icons), business process flows (swimlanes, workflows), ERD diagrams (database schemas), project timelines, UI wireframes, and network topology diagrams. Perfect for proposals, documentation, and architecture reviews. Also generates diagrams from Bicep, Terraform, and ARM templates.

Ask your Agent

Use this Skill: https://skilld.dev/gh/cmb211087/azure-diagrams-skill/azure-diagrams

This session only. Nothing lands on disk.

referencesmermaid-output.md

≈667 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Mermaid Output (zero-install lane)

Mermaid is a text-to-diagram syntax that renders natively, with no install, in GitHub, GitLab, Azure DevOps wikis and Confluence. Use it when the diagram needs to live inside a Markdown doc, PR, or wiki and be editable there, and when you do not need polished Azure service icons.

When to use which

Need Use
Polished Azure service icons, PNG for slides/proposals the diagrams + Graphviz pipeline (the rest of this skill)
Renders in a GitHub/Azure DevOps/Confluence Markdown doc with zero install Mermaid (this file)
Quick edit-in-place flow, sequence, ER or Gantt in a repo doc Mermaid

Mermaid has no Azure icon set, so it is best for flows, sequences, ER and Gantt rather than icon-rich architecture. Embed any block below in a fenced ```mermaid block.

Flowchart (architecture-style)

flowchart LR
    user([User]) --> fd[Front Door]
    fd --> aks[AKS]
    aks --> cosmos[(Cosmos DB)]
    aks --> bus{{Service Bus}}
    bus --> fn[Functions]
    aks -. secrets .-> kv[Key Vault]

Sequence diagram (auth flow)

sequenceDiagram
    actor User
    participant App
    participant Entra as Microsoft Entra ID
    participant API
    User->>App: Open app
    App->>Entra: Redirect to sign in
    Entra-->>App: Authorization code
    App->>Entra: Exchange code for token
    Entra-->>App: Access token
    App->>API: Call API with bearer token
    API-->>App: 200 OK

Entity relationship diagram

erDiagram
    CUSTOMER ||--o{ ORDER : places
    ORDER ||--|{ ORDER_ITEM : contains
    PRODUCT ||--o{ ORDER_ITEM : "ordered in"
    CUSTOMER {
        int id PK
        string email
    }
    ORDER {
        int id PK
        int customer_id FK
        datetime created_at
    }

Gantt (project timeline)

gantt
    title Cloud Migration
    dateFormat YYYY-MM-DD
    section Discovery
    Assessment      :2026-01-01, 14d
    section Build
    Landing zone    :2026-01-15, 21d
    Workload migrate:2026-02-05, 30d
    section Cutover
    Go-live         :2026-03-07, 3d

Architecture-beta (experimental, generic icons only)

Mermaid 11.1+ has an architecture-beta diagram with a small generic icon set (cloud, database, disk, server, internet). It does not include Azure icons, so for branded Azure architecture prefer the diagrams pipeline.

architecture-beta
    group azure(cloud)[Azure]
    service web(server)[Web App] in azure
    service db(database)[Database] in azure
    service store(disk)[Storage] in azure
    web:R --> L:db
    web:B --> T:store

Source: SKILL.md on GitHub

Third-party checks

2 warnings7mo4 checks · Risk SAFE
  • Gen Agent Trust Hub7mo

    The Azure Diagrams Skill is a professional toolkit for generating technical architecture diagrams. It provides comprehensive reference guides and scripts to facilitate the creation of diagrams using the 'diagrams' Python library and Graphviz. Analysis shows the skill follows best practices for file handling, implements appropriate sanitization for its transformation tasks, and contains no malicious code or exfiltration patterns.

  • Socket7mo

    No alerts

  • Snyk7mo

    Risk: MEDIUM · No issues

  • Runlayer7mo

    21/21 files flagged

Provenance

Signed by skilld at ce0fc67. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 3 months ago

Capability

Other metadata
compatibility
Requires the Graphviz system package and the Python diagrams library (>=0.25.1). Works with Claude Code, GitHub Copilot, Cursor, Windsurf, VS Code, and any Agent Skills or AGENTS.md compatible tool.
metadata
{
  "author": "community",
  "version": "2.0.0",
  "repository": "https://github.com/cmb211087/azure-diagrams-skill"
}

README badge

README badge for cmb211087/azure-diagrams-skill