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.

evalsscenarios.md

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

Eval scenarios

Triggering scenarios

These prompts SHOULD activate the skill:

  • "Design a microservices architecture with AKS and Cosmos DB"
  • "Draw a diagram of the Bicep in ./infra"
  • "Create a swimlane for the invoice approval workflow"
  • "Visualise this system as a hub-spoke network"
  • "Generate an ERD for customer and order entities"
  • "Make a 6-month migration timeline"

These should NOT activate it (negative cases):

  • "Explain what AKS is" (no diagram intent)
  • "Refactor this Python function" (unrelated)

If a description change regresses any of these, do not ship it.

Task scenarios

1. Diagram from IaC (deterministic)

Prompt: "Diagram the infrastructure in tests/fixtures/sample-arm.json." Expected: uses scripts/iac_to_diagram.py (or equivalent), producing a PNG with AppServices, CosmosDb, ServiceBus, KeyVaults, VirtualNetworks, ApplicationInsights and the dependsOn edges (plan -> api, plan -> worker, bus -> worker, api -> appinsights). Pass: a PNG is written under diagrams/; all 8 resources appear; no ImportError.

2. Swimlane for invoice approval

Prompt: "Create a swimlane diagram for an invoice approval workflow." Expected: a graphviz/diagrams swimlane with distinct actor lanes (e.g. Submitter, Approver, Finance) and steps connected across lanes; renders to an image. Pass: renders without error; has >= 2 distinct lanes; uses neutral/fictional names only.

3. Hub-spoke topology

Prompt: "Create a hub-spoke network with a hub VNet and two spokes." Expected: follows the hub-spoke pattern in references/common-patterns.md; Bastions imported from diagrams.azure.networking; PNG output. Pass: renders; shows a hub plus two spokes with a firewall and bastion; default PNG.

4. Cross-tool / portability

Prompt (on Windows, e.g. Copilot): "Generate a simple Azure web app diagram." Expected: uses the Windows PowerShell execution path (no bash heredoc), writes to diagrams/, and does not assume /mnt/user-data/outputs. Pass: a PNG is produced on Windows with no path or shell error.

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