Beauty Diagram Skill
beauty-diagram/beauty-diagram-skill
Diagramas de apresentação via Mermaid/PlantUML direto do agente
Ver no GitHubSkill para agentes Claude que transforma código Mermaid e PlantUML em diagramas SVG/PNG prontos para apresentação via CLI `bd`. Gera diagramas a partir de prompts, cria links compartilháveis e URLs embarcáveis para README/Notion sem deixar a conversa.
Instalação
npx convez-ai beauty-diagram/beauty-diagram-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar diagramas de arquitetura e fluxos em conversa com Claude
- Exportar diagramas como SVG/PNG e links compartilháveis
- Embutir diagramas em README, documentação e blogs via URLs
- Beatificar e padronizar diagrama existentes para decks
Veredito

Skill sólido para quem trabalha com documentação visual e apresentações. Integração direta com agentes torna a geração de diagramas fluida, mas requer Node.js e opcionalmente API key para recursos premium. Bom custo-benefício para equipes que vivem em diagrama.
README
A tradução para o português deste README ainda está na fila.
Beauty Diagram skill
Turn Mermaid / PlantUML source into sleek, modern SVG or PNG — straight
from your agent. This skill teaches Claude (or any compatible agent) to call
the bd CLI instead of
hand-authoring SVG, so you get consistent, slide-quality diagrams without
leaving the conversation.
What it does
- Beautifies existing Mermaid / PlantUML files into polished SVG/PNG
- Renders model-generated diagram source on demand
- Generates a diagram from a text prompt via
bd ai generate(Pro / Premium plans only) - Produces shareable
https://www.beauty-diagram.com/s/...links - Generates direct embed URLs for README / Notion / blog use: runs
bd shareand returnshttps://api.beauty-diagram.com/v1/share/<id>.svgrather than emitting raw Mermaid — the URL works as a plain<img src>anywhere that renders images. Anonymous (watermarked) embeds are also available viabd embed-urlwith no sign-in required. - Surfaces actionable error codes (
quota_exhausted,parse_failed,prompt_injection, …) instead of silently retrying
Requirements
- Node.js (for
npx @beauty-diagram/cli); no global install needed - Optional: a Beauty Diagram API key for unwatermarked output, share links, and higher quotas — anonymous demo mode works out of the box (1 export per IP per 24h)
- For AI generation: an API key with the
ai:writescope on a Pro or Premium plan. Anonymous and free plans cannot callbd ai generate.
Get a key at https://www.beauty-diagram.com/account/api-keys.
Triggering
The skill activates when a user asks for things like:
- "beautify this flowchart"
- "make this Mermaid diagram look like a deck slide"
- "give me an SVG of this architecture"
- "draw me a diagram of the signup flow"
- "share this diagram as a link"
Example
You: Here's our service flow in Mermaid — make it slide-ready and give me a share link.
Agent (uses skill):
$ bd beautify flow.mmd --theme modern --out flow.svg
$ bd share flow.mmd --title "Service flow"
→ https://www.beauty-diagram.com/s/abc123
You: Draw me a deploy pipeline diagram and beautify it.
Agent (uses skill, Pro plan):
$ bd ai generate "deploy pipeline with build, test, staging, prod" --out deploy.mmd
$ bd beautify deploy.mmd --out deploy.svg
→ wrote deploy.mmd (editable) + deploy.svg (presentation)
You: Add this architecture diagram to my README as an embedded image.
Agent (uses skill, Pro/Premium plan):
$ bd embed-url ./architecture.mmd --share
→ https://api.beauty-diagram.com/v1/share/abc12345xyz0.svg
Injects into README: 
See examples/ for runnable diagram sources and scripts/ for shell
wrappers you can drop into a repo.
Source-level directives
Both the bd CLI and the Obsidian plugin support bd:KEY=VALUE directives
embedded at the start of your diagram source as native comments. The API
server does not parse them, but because they are valid comment syntax for both
Mermaid and PlantUML, the source renders normally everywhere — graceful
degradation at no cost.
Grammar
Mermaid — one directive per %% comment line:
%% bd:theme=classic
%% bd:bg=transparent
flowchart LR
A --> B
PlantUML — one directive per ' comment line:
' bd:theme=classic
' bd:bg=transparent
@startuml
A -> B
@enduml
Rules:
- All
bd:lines must appear before the first non-blank, non-directive line. - Blank lines between directives are tolerated.
- Multiple directives stack — both
themeandbgcan be set together.
Supported keys
| Key | Accepted values | Notes |
|---|---|---|
theme | classic, modern, slate, atlas, obsidian, brutalist, atelier, blueprint, memphis | Overrides the render theme. Tier gating still applies — anonymous callers get watermarked output regardless of theme. |
bg | transparent | Renders with a transparent canvas. Useful for overlaying on colored slide backgrounds. Any other value is silently ignored. |
Theme tiers: Free — classic, modern, slate; Pro — adds atlas,
obsidian, brutalist, atelier; Premium — adds blueprint, memphis.
Override priority
CLI flag > source directive > server default
A --theme atlas flag always wins over a %% bd:theme=classic directive in
the source. Directives are useful when the file is the single source of truth
(shared repos, Obsidian vaults) and the CLI flags aren't part of the workflow.
Why use directives instead of CLI flags?
- The theme intent travels with the file — anyone who opens the
.mmdin the Obsidian plugin, or runsbd beautifywithout--theme, still gets the right style. - Works transparently in the Obsidian plugin, where there is no CLI invocation.
- Directives are stripped before the source reaches the renderer — they do not appear in the SVG output.
Files
beauty-diagram-skill/
├── SKILL.md # agent-facing instructions
├── examples/ # sample Mermaid sources
│ ├── flowchart.mmd
│ └── sequence.mmd
└── scripts/ # copy-pasteable shell wrappers
├── beautify.sh
├── export.sh
└── ai-generate.sh # prompt → .mmd → .svg
Links
- Site: https://www.beauty-diagram.com
- CLI on npm: https://www.npmjs.com/package/@beauty-diagram/cli
- API keys: https://www.beauty-diagram.com/account/api-keys
License
MIT-0 (per ClawHub publishing terms).