amw-diagram-architecture

Convert free-text system descriptions into layered architecture diagrams as graph JSON, SVG, or PNG.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/Emasoft/ai-maestro-webdesign --skill amw-diagram-architecture-emasoft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: amw-diagram-architecture
Source: https://github.com/Emasoft/ai-maestro-webdesign/tree/main/skills/amw-diagram-architecture
Command: npx skills add https://github.com/Emasoft/ai-maestro-webdesign --skill amw-diagram-architecture-emasoft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a written description of a system into a clean, readable architecture diagram normally requires manual layout work in a diagramming tool, and naive LLM generation produces cluttered, unbalanced graphs. This Skill generates a validated layered architecture diagram directly from free text, enforcing visual-quality budgets so the result stays readable. ## Core Features & Use Cases - Text-to-diagram pipeline: Generates a canonical layered graph JSON (title, layers, nodes, edges) from a free-text system description via a structured-outputs LLM call, then transforms it into graph JSON, self-contained SVG, or PNG (SVG plus export instructions). - Two-stage validation: Stage 1 enforces structural rules (3–5 layers, 6–12 nodes, edge budget of floor(n × 0.8), ID and layer-order integrity); Stage 2 checks format-level output such as SVG well-formedness and layout sanity. - Opt-in versioning: Persists diagram revisions as YAML files with a history log, supporting save, diff, rollback, and natural-language edits across long sessions. - Use Case: Paste a paragraph describing your SaaS platform (web app, API gateway, services, database) and receive a balanced 4-layer SVG architecture diagram with color-coded layer bands, ready to embed in documentation. ## Quick Start Ask the assistant to draw an architecture diagram of your system, for example: "Draw a layered architecture diagram of my e-commerce backend as SVG."

Frequently Asked Questions about amw-diagram-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an architecture diagram from a text description?▼

Provide a free-text description of your system and choose an output format: graph JSON, SVG, or PNG. The skill calls an LLM with a constrained schema to produce a layered graph, validates it, then renders the diagram in your chosen format.

What output formats does the architecture diagram support?▼

Three formats are supported: graph JSON (the canonical layered structure), self-contained SVG renderable in any browser, and PNG (the same SVG plus instructions for conversion via browser, sharp, cairosvg, or Inkscape). Mermaid output is routed to a separate dedicated skill.

Can I export the architecture diagram as PNG?▼

Yes. The PNG format returns the SVG plus an instructions block covering browser save-as, Node sharp, Python cairosvg, Inkscape CLI, and online converters. If cairosvg is installed, the companion render script can rasterize automatically.

Why does my generated diagram drop some edges or nodes?▼

The skill enforces visual-clarity budgets: 3–5 layers, 6–12 nodes, and at most floor(n × 0.8) edges. Validation prunes cross-layer-skip and same-layer edges first, so technically correct but non-essential connections may be removed to keep the diagram readable.

Does it support versioning and rollback of diagrams?▼

Yes, via an opt-in feature that stores each revision as YAML (v1.yaml, v2.yaml, etc.) with a history.yaml log. You can save, diff, list, and roll back versions, and apply natural-language edits like add, remove, connect, or rename.

When should I not use this skill for diagrams?▼

Avoid it for editorial infographics, freeform non-layered SVGs, user-flow or UX journey charts, and Mermaid source generation — those route to sibling skills. It is purpose-built for layered system architecture diagrams only.