Skip to content

Add Azure Architecture Diagrams skill#855

Open
hanv89 wants to merge 1 commit into
ComposioHQ:masterfrom
hanv89:add-azure-architecture-diagrams
Open

Add Azure Architecture Diagrams skill#855
hanv89 wants to merge 1 commit into
ComposioHQ:masterfrom
hanv89:add-azure-architecture-diagrams

Conversation

@hanv89
Copy link
Copy Markdown

@hanv89 hanv89 commented May 16, 2026

Adding Azure Architecture Diagrams to Development & Code Tools (alphabetically between aws-skills and Changelog Generator).

What it is

A self-contained Claude Skill for drawing Microsoft Azure and Microsoft Fabric architecture diagrams in PlantUML, using literal <img:URL> references to 840 redistributed first-party-MIT-licensed icons:

  • Azure: 528 icons from plantuml-stdlib/Azure-PlantUML (MIT community redistribution).
  • Microsoft Fabric: 312 icons from @fabric-msft/svg-icons (Microsoft first-party MIT).

Why it qualifies

  • Real use case — installed and in daily use by the maintainer's team; six worked examples ship in the bundle (context, data pipeline, system architecture, sequence flow, component view, deployment).
  • Standalone value — MIT, no paid component, no SaaS wrapper, no telemetry. The npm CLI fetches the skill bundle from raw GitHub and that's it.
  • Testednpm test covers 50 cases; bash unit + fixture tests for build scripts and the monitor scripts. Docker smoke validates --version + install --version=1.1.0 against the live npm registry on every release.
  • Tri-agent — supports --agent=claude-code | codex | cursor (or --agent=all). Per-project Cursor model, per-user Claude Code / Codex model.

Install

npx @hanv89/azure-arch-skill@latest install --agent=claude-code

In a fresh Claude Code session: "Draw an Azure AKS architecture feeding a Microsoft Fabric data plane (OneLake + Lakehouse + Power BI)." The agent emits a .puml using <img:> tokens, renderable at play.plantuml.com, Confluence, or GitHub inline.

Network calls / permissions

No --dangerously-skip-permissions. The CLI fetches only from raw.githubusercontent.com (skill bundle + icon paths verified at install). No Anthropic API, no telemetry, no third-party endpoint.

v1.1.0 highlight — icon discovery

v1.1.0 introduced per-vendor INDEX.md (dist/Azure/INDEX.md, dist/Fabric/INDEX.md) — a flat markdown catalog of path | name | category | description | tags. The skill teaches the agent to grep INDEX.md instead of guessing filenames, which matters because upstream filenames sometimes diverge from product names (Microsoft Entra IDAzureActiveDirectory.png, Azure DDoS ProtectionAzureAzureDDoSProtection.png).

Links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant