
Generating Visual Diagrams
Generate Salesforce architecture, integration-flow, and ERD diagrams from structured prompts—including architect.salesforce.com-style ERD defaults—for specs and stakeholder reviews.
Install
npx skills add https://github.com/forcedotcom/sf-skills --skill generating-visual-diagramsWhat is this skill?
- Integration Flow architecture template with systems list, protocols, API gateway, auth, middleware, and error-retry comp
- Example gemini /generate command for Salesforce–MuleSoft–SAP REST/BAPI and Platform Events flows with OAuth badges
- ERD template defaults to architect.salesforce.com style: dark border, translucent fill, header banner, LEGEND bar, label
- Prompt templates request landscape layout, hub-spoke or left-to-right flow, and explicit legends
Adoption & trust: 687 installs on skills.sh; 513 GitHub stars; 3/3 security scanners passed (skills.sh audits).
Recommended Skills
Journey fit
Diagram generation most often ships with build-time documentation, but the same templates support validate prototypes and launch architecture storytelling. Visual specs belong in docs: integration flows, ERDs, and legends that agents and humans reuse in READMEs and design packets.
Common Questions / FAQ
Is Generating Visual Diagrams safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Generating Visual Diagrams
# Architecture Template: Integration Flow ## Prompt Template ``` Professional Salesforce integration architecture diagram: SYSTEMS: [List systems with types and icons] INTEGRATION PATTERNS: [List integrations with protocols and directions] COMPONENTS: - API Gateway (if applicable) - Authentication layer - Middleware/ESB (if applicable) - Error handling/retry logic STYLING: - Cloud icon for Salesforce - Server icons for external systems - Arrows with protocol labels - Color coding by system type - Professional diagram style FORMAT: - Landscape orientation - Left-to-right or hub-spoke layout - Include legend ``` ## Example ```bash gemini "/generate 'Salesforce integration architecture diagram: Systems: 1. Salesforce (cloud icon, blue) 2. MuleSoft (middleware icon, purple) 3. SAP ERP (server icon, orange) Flows: 1. Salesforce --REST--> MuleSoft --BAPI--> SAP - Account/Contact sync (bidirectional) 2. SAP --Events--> MuleSoft --Platform Events--> Salesforce - Invoice updates Include: - OAuth 2.0 authentication badges - Error queue for failed messages Style: Professional, clean lines, pastel colors'" ``` # ERD Template: Core Salesforce Objects (Architect.salesforce.com Style) ## Default Style All ERDs now use the **official architect.salesforce.com aesthetic** by default: - Dark border + light translucent fill boxes - Header banner with Salesforce logo - LEGEND bar with ENTITIES and RELATIONSHIPS - Labeled relationship lines - Footer with copyright See `references/architect-aesthetic-guide.md` for full specification. --- ## Prompt Template (Architect.salesforce.com Style) ``` Create a Salesforce Core CRM ERD in the EXACT architect.salesforce.com style: PAGE TITLE (very top, large bold text): 'Core CRM Overview Data Model' HEADER SECTION (below title): - Left: Salesforce cloud logo + 'SALESFORCE PLATFORM Overview' in dark teal (#0B827C) banner box - Center: LEGEND with 'ENTITIES' section showing: * Cloud Entity box (dark teal #0B827C border, light teal ~25% opacity fill) * Related Entity box (dark teal border, lighter fill) * External Entity box (black border, white fill) - Right: 'RELATIONSHIPS' section showing notation symbols for Parent/Child, Required, Optional, Many-to-Many BOX STYLING - CRITICAL: - DARK BORDER: Solid 2px border in dark teal (#0B827C) - LIGHT TRANSLUCENT FILL: Same teal hue at ~25% opacity - Rounded corners (8-12px radius) - Text in dark gray/black on the light fill ENTITY BOX FORMAT: ┌─────────────────────────┐ │ Logical Name │ (Bold, larger) │ APIName │ (Smaller, italic, gray) │ • Field1 │ (Bullet points) │ • Field2 │ └─────────────────────────┘ OBJECTS TO INCLUDE (all with dark teal border + light teal fill): - Account (center position): Account Account • Account Number • Name • Industry • Type - Contact (linked to Account): Contact Contact • Name • Email • Title • Phone - Opportunity (linked to Account): Opportunity Opportunity • Name • Amount • Close Date • StageName - Case (linked to Account and Contact): Case Case • CaseNumber • Type • Priority • Status RELATIONSHIP LINES: - Thin black lines with text labels ON the lines - Contact → Account: "child of" (crow's foot on Contact side) - Opportunity → Account: "child of" (crow's foot on Opportunity side) - Case → Account: "related to" (crow's foot on Case side) - Case → Contact: "related to" (optional) - STRAIGHT LINES ONLY (horizontal and vertical, no diagonals) FOOTER: Left: '©2024 Salesforce - Subject to change without notice' Right: 'Last modified: [current date]' CRITICAL: Dark teal borders with LIGHT translucent teal fill - NOT solid filled boxes. ``` --- ## Usage ```bash # Quick draft at 1K (iterate here) gemini --yolo "/generate '[paste prompt above]'" open ~/nanobanana-output/*.png # Review and refine # Final at 4K (when satisfied) uv run scripts/generate_image.py \ -p "[your refined prompt]"