stack-diagram: architecture diagrams from one sentence
Added NewCopyable prompt below
Published Last verified Released
Our verdict
The quickest way we've seen to get a presentable stack diagram for a README, pitch deck or design doc without opening a drawing tool: logos are fetched from official sources rather than redrawn, lines are routed around labels, and the agent renders and checks the picture before handing it over. It's very new (first release 1 Nov) and does one job, so treat it as a docs helper, not a modelling tool. Before you install, note that it offers to post your diagram to a public gallery (it asks twice, so check for internal names) and that the skills installer sends anonymous usage data unless you turn telemetry off.
- Who it's for
- Developers, founders and technical writers who need architecture diagrams for READMEs, wikis, pitch decks or onboarding docs, and already use a coding agent
- Leverage
- A clean, logo-accurate architecture diagram in minutes from a plain-English description, instead of hunting for logos and aligning boxes by hand
- Effort
- Low
- Date added
What it does
stack-diagram (caru-ini/stack-diagram, MIT) is an agent skill. You describe the stack in plain English; the agent picks the services, fetches official logos (svgl, then devicon, then gilbarbara/logos or the brand's own repository; AWS, Google Cloud and Azure icons come from each vendor's own icon package), lays out groups and connections, renders the result and checks it before showing you. Output is one HTML file with fonts and logos inlined, so it renders offline, plus light and dark PNGs, a dependency-free React component or a Claude artifact. It needs Python 3.9+ and network access for logos; PNG export uses Playwright with Chromium. An optional public gallery at stacks.caru.moe takes diagrams only after you confirm twice; the README says your prompt is never sent.
How builders use it
- Install with npx skills add caru-ini/stack-diagram (in the Claude apps, upload stack-diagram.zip from the GitHub Releases page as a skill).
- Describe the stack in one or two sentences, naming hosts, databases, auth, payments and CI, e.g. Next.js and a Hono API on Vercel, Postgres on Neon, Clerk, Stripe, GitHub Actions.
- Pick the format you need: the default single HTML file for a wiki or repo, PNGs for slides, or a React component for a docs site.
- Say no to the gallery offer for anything internal, and check the diagram's connections against what your system really does.
What to expect
A shareable architecture diagram with official logos, in light and dark themes, ready to drop into a README, wiki or deck.
Copy this: Install + first diagram
# Official source: github.com/caru-ini/stack-diagram (MIT). Needs Python 3.9+; PNG export uses Playwright + Chromium.
npx skills add caru-ini/stack-diagram
# Then ask your agent (examples from the README):
Diagram our stack: Next.js and a Hono API on Vercel. Postgres on Neon, auth with Clerk, payments with Stripe. GitHub Actions deploys.
Draw our app on AWS: CloudFront in front of S3 and an ALB in a public subnet. Fargate, RDS and ElastiCache sit in a private subnet.
# Before sharing: the agent offers to post to a public gallery. Decline for internal systems.Related discoveries
See the newest picks →- ToolCreative & Media
Anatomy: interactive isometric explainer figures from your agent
MIT agent skill for Claude Code, Codex, OpenCode and others that turns a technical idea into an interactive isometric machine as HTML, SVG or React.
Effort: LowPrompt#Image#Open source
- ToolCreative & Media
Shaders: WebGPU effects your coding agent can install
MIT library of 200+ WebGPU effects as components, with an agent skill and MCP server for coding agents.
Effort: LowPrompt#Image#Plugin / extension
- ToolCreative & Media
Stageshow: polished faux product UI from your coding agent
MIT agent skill from designer Benji Taylor that makes your coding agent build launch-page product shots, cursor demos and bento grids as React components, then film and fix them.
NewEffort: MediumPrompt#Image#Video
- ToolCreative & Media
teardown: 3D machine simulators from Claude Code
MIT Claude Code skill that turns "how does this machine work?" into one offline three.js page: the machine runs in the middle, panels read its numbers, parts open up, and it can film a 60 fps tour.
NewEffort: MediumPrompt#Video#Plugin / extension
Get the best new A.I. picks in your inbox
The best new agent workflows and tools we’ve vetted, with a clear verdict on each. Short, occasional, useful.