Architecture Diagramming Expert

Create OCI architecture diagrams with D2, Draw.io, or Mermaid.

2|1|Updated Sep 1, 2025
One-click install
npx skills add https://github.com/frankxai/ai-architect-academy --skill architecture-diagramming-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architecture Diagramming Expert
Source: https://github.com/frankxai/ai-architect-academy/tree/main/claude-ai-architect/skills/architecture-diagramming
Command: npx skills add https://github.com/frankxai/ai-architect-academy --skill architecture-diagramming-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to visualize cloud architectures by generating professional diagrams using D2, Draw.io, Mermaid, and OCI icons, supporting clear communication and decision-making.

Core Features & Use Cases

  • Tool-chooser guidance: Recommends the best diagramming tool (D2 for layouts, Draw.io for OCI-icon-rich visuals, Mermaid for docs) based on project needs.
  • OCI icon integration: Enables diagrams using OCI icon kits to match enterprise standards.
  • Use Case: Create an OCI GenAI architecture diagram showing data flow between a web app, API gateway, and DAC, ready for presentation.

Quick Start

Use the architecture diagramming skill to build a diagram titled "OCI GenAI Architecture" and export as SVG or PNG.

Frequently Asked Questions about Architecture Diagramming Expert

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

FAQPage Schema
How do I create an OCI architecture diagram with standard cloud icons?

Create OCI architecture diagrams using integrated OCI icon kits within D2, Draw.io, or Mermaid outputs. The skill enforces tool-specific templates and frontmatter configuration to generate consistent, enterprise-ready visuals for documentation and design reviews.

What's the best way to choose between D2, Draw.io, and Mermaid for cloud diagrams?

Choosing the right diagramming tool depends on your project needs: D2 is recommended for automated layouts, Draw.io for OCI-icon-rich visuals, and Mermaid for embedding diagrams directly into documentation.

Can I export Mermaid or D2 diagrams as SVG and PNG files?

Yes, the skill enforces tool-specific outputs supporting both SVG and PNG export formats. This ensures your OCI-based cloud architecture visuals are ready for presentations and implementation planning.

Do I need any specific software installed to generate OCI architecture diagrams?

No external dependencies are required to generate the diagram code and frontmatter configuration. The skill outputs D2, Draw.io, or Mermaid syntax that renders into SVG or PNG using standard visualization tools.

How does frontmatter-driven configuration work for architecture diagramming?

Frontmatter-driven configuration standardizes diagram generation by defining tool selection, output formats, and OCI icon templates. This mechanism ensures consistent visual outputs across different teams and documentation reviews.