skills.rest
thevgergroup
thevgergroupOFFICIAL
Explore all skills by this author →
WebsiteGitHub

architect-diagram

Translate natural language architecture descriptions into YAML diagram specifications.

Updated Mar 24, 2026
Search Tags:#automation#architecture#claude#yaml#cloud#diagram
One-click install
npx skills add https://github.com/thevgergroup/mad-skills --skill architect-diagram
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect-diagram
Source: https://github.com/thevgergroup/mad-skills/tree/main/skills/architect-diagram
Command: npx skills add https://github.com/thevgergroup/mad-skills --skill architect-diagram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates natural language descriptions of systems into ready-to-render architecture diagrams, saving time from manual diagramming and ensuring consistent visual conventions.

Core Features & Use Cases

  • Converts user descriptions into a YAML diagram specification that can render with D2 for deeply nested infra or with the diagrams engine for simpler concepts.
  • Auto-detects the appropriate engine (D2 for VPCs, subnets, AZs, or hybrid layouts; diagrams for high-level diagrams) and supports an explicit engine override.
  • Provides companion docs under the skill for installation, schema references, and examples; supports saving the generated YAML for reuse.

Quick Start

Describe your architecture in natural language and run the Skill to generate a diagram YAML and render it.

Frequently Asked Questions about architect-diagram

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

FAQPage Schema
How do I generate cloud architecture diagrams from natural language descriptions?▼

Generate cloud architecture diagrams by providing a natural language description that Claude translates into a structured YAML specification. The Skill auto-detects the rendering engine and returns a ready-to-render diagram file path for immediate use.

What is the difference between the D2 and diagrams engines for rendering YAML specs?▼

The D2 engine handles deeply nested infrastructure diagrams like VPCs, subnets, and availability zones, while the diagrams engine renders simpler high-level conceptual diagrams. The Skill auto-detects the correct engine but supports an explicit override for custom control.

Can I save and reuse the YAML diagram specification after generating it?▼

Yes, you can save the generated YAML diagram specification for reuse. The Skill outputs the YAML spec alongside the rendered diagram file path, allowing you to version control or modify the structured architecture definition for future rendering.

How do I create an infrastructure diagram for VPCs and subnets without manual drawing?▼

Create infrastructure diagrams by describing your VPCs, subnets, and availability zones in natural language. The Skill automatically detects the D2 rendering engine for deeply nested hybrid layouts and generates the visual output without manual diagramming tools.

Do I need to install D2 or diagrams engine tools separately to use this Skill?▼

The Skill uses dedicated generator scripts to render diagrams via the D2 or diagrams engine. It provides companion documentation under the skill for installation, schema references, and examples to ensure the required rendering engines are properly configured.

Related Skills

Explore More Software Engineering Skills→
diegomarinodiegomarino
56

d2-diagram

Generate D2 diagrams from natural language descriptions with type classification.

Community
Advanced
jctannerjctanner

generate-architecture-diagrams

Generate Mermaid, C4, ASCII, and PNG architecture diagrams from documentation.

Community
Advanced
Design-System-ETDesign-System-ET

devops-engineer

Automate CI/CD pipelines, Kubernetes manifests, and infrastructure-as-code templates.

Official
Advanced
rysweetrysweet
2

mermaid-diagram-generator

Convert architecture and workflow descriptions into valid Mermaid diagrams.

Community
Intermediate