D2 Diagram Generator for Azure

Turns Terraform Azure infra into icon-accurate D2 architecture diagrams via a mandatory scope questionnaire and live icon lookup.

par miiitch · miiitch/d2-gen

Fonctionne avec configuration ★ 8.4/10

D2 Diagram Generator for Azure — Turns Terraform Azure infra into icon-accurate D2 architecture diagrams via a mandatory scope questionnaire and live icon lookup.

Ce que fait

Reads Terraform/Terragrunt (and, per its own description, Bicep) Azure infrastructure code and generates D2 diagram source with real Azure service icons, resource-group containers, hidden-sub-resource styling, and rule-based internet-exposure detection, then renders it via the external d2 CLI. Triggers on requests to diagram Terraform/Azure infrastructure; explicitly excludes runtime debugging and draw.io output. Requires the d2 CLI to be installed separately and is documented in its own repo README as a GitHub Copilot skill with no Claude-specific install instructions, though the SKILL.md format itself works fine when copied into a Claude skills folder.

Rapport de test

Ran it for real on a 3-resource Terraform snippet (Function App + Storage + Service Plan): it correctly resolved live Azure icons from the repo's own GitHub-hosted JSON index and rendered a valid SVG via `d2 --layout=elk --theme=1` - but its description advertises Bicep support while the SKILL.md's own Icon Source Requirement section only ever wires in the Terraform icon mapping URL, so a real Bicep diagram would silently fall back to plain rectangles for every single resource despite a working icon-index-bicep-png.json sitting unused in the same repo.

Testé le: 2026-07-14 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/miiitch/d2-gen
cd d2-gen
mkdir -p ~/.claude/skills
cp -r skills/d2-gen-azure ~/.claude/skills/d2-gen-azure

Commandes et exemples de prompts

  • /d2-gen-azureTurns Terraform Azure infra into icon-accurate D2 architecture diagrams via a mandatory scope questionnaire and live icon lookup.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Turn my Terraform Azure setup into an architecture diagram
  • Draw our cloud infra with proper Azure service icons
  • Which of my Azure resources are exposed to the internet?