generating-visual-diagrams

generating-visual-diagrams: Salesforce Visual AI Skill

Use this skill when the user needs rendered visuals, not text diagrams: ERDs, UI mockups, architecture illustrations, slide-ready images, or image edits using Nano Banana Pro.

Scope

In scope:

• PNG / SVG-style rendered image output
• Visual ERDs and architecture diagrams
• LWC or Experience Cloud mockups / wireframes
• Image edits on previously generated visuals

Out of scope — delegate instead:

• Mermaid or text-only diagrams → generating-mermaid-diagrams
• Object / field metadata discovery for ERDs → generating-custom-object or generating-custom-field
• LWC implementation after the mockup is approved → generating-lwc-components
• Apex review / implementation → generating-apex

Hard Gate: Prerequisites First

Run the prerequisites check before using the skill:

scripts/check-prerequisites.sh

If prerequisites fail, stop and route the user to setup guidance in:

• references/gemini-cli-setup.md [blocked]

Required Inputs

Ask for or infer before generating:

Interview-First Workflow

Unless the user asks for quick / simple / just generate, ask clarifying questions first using the question bank in references/interview-questions.md [blocked].

Quick mode defaults (triggered by "quick", "simple", "just generate", "fast"):

• professional style, 1K draft, legend included, one image first then iterate

Recommended Workflow

1. Run prerequisites check

Run scripts/check-prerequisites.sh and confirm all required tools pass before proceeding.

2. Gather inputs

• object list / metadata (delegate to generating-custom-object / generating-custom-field if needed)
• purpose: draft vs presentation vs documentation
• desired aesthetic — read references/architect-aesthetic-guide.md [blocked] for ERDs
• aspect ratio / resolution

3. Run interview or use quick-mode defaults

Load references/interview-questions.md [blocked] for the matching question set (ERD, LWC, architecture, code review).

4. Build a concrete prompt

Good prompts specify subject, composition, color treatment, labels/legends, and output quality goal.

5. Generate a fast draft at 1K

gemini --yolo "/generate 'Your prompt here'"

Open the result and review layout before spending on higher resolution.

6. Iterate using edits

gemini --yolo "/edit 'Specific change instruction'"

Use /edit for small adjustments — cheaper than regenerating. See references/iteration-workflow.md [blocked].

7. Generate final at 2K/4K using the Python script

Run scripts/generate_image.py when layout is confirmed:

uv run scripts/generate_image.py -p "Refined prompt" -f "output.png" -r 4K

8. Error recovery

• If gemini --yolo returns no image: re-run once; if it fails again, fall back to the Python script path.
• If the Python script fails with GEMINI_API_KEY not found: verify the key is exported in your shell profile (~/.zshrc on macOS/zsh, ~/.bashrc on Linux) and the terminal session is refreshed.
• If the extension is missing: run gemini extensions install nanobanana and re-run the prerequisites check.

Default Style Guidance

For ERDs, default to the architect.salesforce.com aesthetic unless the user asks otherwise:

• dark border + light fill cards
• cloud-specific accent colors
• clean labels and relationship lines
• presentation-ready whitespace and hierarchy

Full style specification: references/architect-aesthetic-guide.md [blocked]

Common Patterns

Output Expectations

Deliverables produced by this skill:

• Draft image (<name>.png) — 1K resolution rendered via gemini --yolo "/generate ..." for layout review
• Final image (<name>.png) — 2K or 4K resolution rendered via scripts/generate_image.py once composition is approved
• Edit iteration (<name>.png) — incremental refinement via gemini --yolo "/edit ..." without full regeneration

After delivering each image:

• Open the file in Preview or attach it in the session for multimodal review
• Ask the user whether to iterate on layout, labeling, or color before finalizing
• Only proceed to high-res output after draft composition is confirmed

Rules / Constraints

Gotchas

Cross-Skill Integration

Reference File Index