architect-diagram

Generate grounded Mermaid diagrams for systems, flows, states, and entity relationships.

15|5|Updated May 4, 2026
One-click install
npx skills add https://github.com/eugenelim/agent-ready-repo --skill architect-diagram-eugenelim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-diagram
Source: https://github.com/eugenelim/agent-ready-repo/tree/main/packs/architect/.apm/skills/architect-diagram
Command: npx skills add https://github.com/eugenelim/agent-ready-repo --skill architect-diagram-eugenelim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns architecture thinking into readable Mermaid diagrams so you can explain systems, integrations, lifecycles, and deployment layouts without hand-drawing structure or guessing at notation.

Core Features & Use Cases

  • Notation routing: Chooses flowchart, sequence, state, ER, or C4-style output based on the user's intent.
  • Grounded documentation: Reads the repository first, and for as-is diagrams keeps names, boundaries, and relationships anchored to real code and docs.
  • Cloud and agent awareness: Handles AWS, Azure, GCP, and managed agent platforms with the right trust boundaries and edge labels.
  • Readable outputs: Keeps diagrams compact, labeled, and suitable for wiki rendering.
  • Use case: Use it to draft a deployment topology for a microservice repo, review an existing sequence diagram, or update a system map after an architecture change.

Quick Start

Ask this skill to draw the system or flow you want documented, and it will return a grounded Mermaid diagram with the right notation and boundaries.

Frequently Asked Questions about architect-diagram

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

FAQPage Schema
How do I generate Mermaid diagrams for system architecture from a repository?

The skill generates grounded Mermaid diagrams by reading your repository first, anchoring names, boundaries, and relationships to real code and documentation. It routes to the correct notation like flowchart, sequence, state, or ER based on your specific system design intent.

What is the best way to document cloud deployment topologies for AWS, Azure, or GCP?

The best way to document cloud deployment topologies is using C4-style Mermaid diagrams with correct trust boundaries and edge labels. The skill handles AWS, Azure, GCP, and managed agent platforms to produce compact, readable topology maps for your architecture documentation.

Can I use this approach to reverse-engineer an existing codebase into sequence diagrams?

Yes, you can reverse-engineer a repository into sequence diagrams. The skill reads your codebase to map real system interactions and flows into grounded Mermaid sequence diagrams, ensuring correct notation routing and one-screen readability without fabricating entity names.

Does notation routing automatically choose between flowchart, state, ER, and C4 models?

Yes, notation routing automatically chooses between flowchart, sequence, state, ER, or C4-style Mermaid output based on your stated intent. This ensures the generated diagram accurately represents the specific system structure, lifecycle, or entity relationships you need documented.

What are the limitations when generating architecture diagrams for complex agentic systems?

A limitation when generating architecture diagrams for complex agentic systems is maintaining one-screen readability without fabricated names. The skill requires accurate repository references to establish visible trust boundaries and labeled relationships, preventing ungrounded or overly cluttered Mermaid outputs.