SkillPartly tested (needs an account)
Draw your app's architecture diagram
stack-diagram
Free MIT skill: describe the services your app uses in one sentence and get a clean diagram with their official logos, as HTML or PNG.
- Works with
- Claude Code, Codex CLI
- Good for
- Build an app, Graphic designers
What it does
stack-diagram turns a sentence about your app into a picture of how its parts connect. You name the pieces, such as the website, the database, the sign-in service and the payment provider. Your assistant draws boxes with each company's real logo and lines that show what talks to what.
It is useful when you built something with an assistant and now need to explain it to a client, a partner or a future helper. It also works for cloud setups on AWS, Google Cloud and Azure, with each vendor's own icons.
The result is one HTML file that opens in any browser without internet, in a light and a dark version. You can also ask for a PNG image or a small React component for your site. The assistant renders the diagram and looks at it before it gives it to you.
npx skills add is the only command-line install route in the README, for Claude Code, Codex and other agents.
Example prompts
- "Diagram our stack: Next.js and a Hono API on Vercel, Postgres on Neon, auth with Clerk, payments with Stripe."
- "Draw how my website, my Supabase database and my email service connect."
- "Make the same diagram as a PNG in light and dark."
- "Draw our app on AWS: CloudFront in front of S3, and Fargate with RDS in a private subnet."
How to install
npx skills add caru-ini/stack-diagramHow to use it
Describe your setup in plain words, for example: "Diagram our stack: Next.js on Vercel, Postgres on Neon, auth with Clerk, payments with Stripe."
Check it works
After installing, start a new session and ask your assistant to diagram a simple stack. It should create an HTML file and tell you where it saved it. When it offers to share the diagram to the gallery, you can say no.
Common problems
- Logos are missing — the skill fetches logos online, so it needs network access to the icon sites — https://github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/skills/stack-diagram/SKILL.md
- PNG export fails — PNG output uses Playwright with Chromium, which must be installed — https://github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/skills/stack-diagram/SKILL.md
- Scripts fail to run — the skill needs Python 3.9 or newer on your computer — https://github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/README.md
- You shared a diagram by mistake — the assistant can run
python3 scripts/share.py delete <id>with the saved key (share.py listshows your posts) — https://github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/skills/stack-diagram/scripts/share.py
Other assistants
- Codex: the same
npx skills add caru-ini/stack-diagram, which the README gives for Claude Code, Codex, Cursor and other agents that read skills — https://github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/README.md - Claude apps: upload
stack-diagram.zipfrom the latest release as a skill — https://github.com/caru-ini/stack-diagram/releases/tag/v0.4.0 - Gemini CLI: the README does not name it, and it is not in the Gemini CLI extensions gallery — https://geminicli.com/extensions/
What to watch out for
- The assistant runs the skill's Python scripts on your computer (Python 3.9 or later, standard library only). fetch_icons.py downloads logos from svgl.app, raw.githubusercontent.com, cdn.jsdelivr.net, AWS (aws.amazon.com, d1.awsstatic.com), Google (services.google.com) and Microsoft (learn.microsoft.com, arch-center.azureedge.net), plus any brand site you name
- PNG export needs Playwright with Chromium. The SKILL.md tells the assistant to install them with pip install playwright and python3 -m playwright install --with-deps chromium, which downloads a browser (and can ask for system packages)
- Public gallery: after drawing, the assistant offers once to post the diagram to https://stacks.caru.moe. On a first yes it asks for a display name and an optional GitHub login; then it shows what will go public and posts only after a second yes on that exact content (SKILL.md step 7). This two-yes rule is an instruction to the assistant; share.py itself posts whatever it is given
- What a gallery post sends (scripts/share.py): the light and dark PNGs, an English title, the list of technologies (with logo links from svgl, gilbarbara/logos or devicon only), your display name and the GitHub login if you agreed. Your prompt is not sent. The gallery can hold a post for manual review, and a delete key is saved in ~/.config/stack-diagram/gallery.json. Say no if the diagram shows hostnames, IP addresses, customer names or other private details
- The npx skills installer sends anonymous install data; set DISABLE_TELEMETRY=1 to turn it off
Licence and author
- Licence
- MIT
- Author
- caru-ini
- Source code
- github.com/caru-ini/stack-diagram
How we tested it
We installed it on an empty test computer on 3 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
Technical details of the test
- Date
- 3 Nov 2026
- Method
- Reviewed by our team against the repository, its README and docs.
Checked again on 3 Nov 2026
Alternatives
- Archify — turns ideas and code into diagrams
- Diagram Design — draws clean diagrams as web pages
- Next AI Draw.io — draws diagrams on a live draw.io canvas you can edit
- Planning with Files — keeps a written plan, with no pictures
FAQ
- Q: Do I need to draw anything? A: No. You describe the parts in words, and the assistant draws and checks the diagram.
- Q: Is my prompt shared online? A: No. Only an optional gallery post goes online. It needs two yeses, and share.py sends the two images, a title, the technology list and the name you chose, not your prompt.
- Q: Can I put the logos in a client deck? A: The logos are trademarks of their owners. The README says the skill shows them as they are and that their use implies no endorsement.
Sources
- github.com/caru-ini/stack-diagram
- github.com/caru-ini/stack-diagram/tree/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838
- github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/README.md
- github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/skills/stack-diagram/SKILL.md
- github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/skills/stack-diagram/scripts/share.py
- github.com/caru-ini/stack-diagram/blob/1ed53e3e9525364ae5d82e0430f2bb3f7ef4c838/skills/stack-diagram/scripts/fetch_icons.py
- github.com/caru-ini/stack-diagram/releases/tag/v0.4.0
- learn.chatgpt.com/docs/build-skills
- github.com/vercel-labs/skills