Cloud Arch Deck — DevOps skill for Claude Code

cloud-arch-deck

Generate **customer-ready architecture diagrams and capability decks** as editable PowerPoint — for Azure, AWS and open-source stacks — from code.

Native shapes, real vendor logos, and a layout language that survives review by a customer's platform and security team. Works standalone, or as a [Claude Code](https://claude.com/claude-code) skill so you can ask for a diagram in plain language and get a `.pptx` back.


Why this exists

Architecture slides usually fail in one of three ways. They are a screenshot pasted onto a slide, so nobody can edit them. They use hand-drawn boxes instead of real service icons, so nobody believes them. Or they show components without a network boundary, a request path or a trade-off, so the customer's security team sends them back.

This fixes all three, and it does it from code — so the diagram is diffable, repeatable, and regenerates when the design changes.

What you get

• Three icon sets behind one command — ~666 Azure, ~809 AWS, ~3,400 open source
• Editable PowerPoint, native shapes, no rasterised diagrams
• A layout language for architecture slides: containers, network boundaries, subnets with real CIDRs, numbered request paths, connectivity legends, scope colour-coding
• Deck blocks — cover, content slide, grid, cards, comparison panels, stat bands
• A render-and-inspect loop, because generating a deck is not the same as looking at one
• A known-defects table in references/conventions.md — every layout bug found the hard way, with its cause and fix

Install

git clone https://github.com//cloud-arch-deck.git
cd cloud-arch-deck

brew install librsvg poppler              # rsvg-convert, pdftoppm
brew install --cask libreoffice           # headless render, for inspection
npm install pptxgenjs                     # in whatever folder you generate from

Linux: `apt install librsvg2-bin poppler-utils libreo