Sf Diagram Mermaid
Generate Mermaid flowcharts that document Salesforce Agentforce service agents, topics, actions, and conversation flows for architecture review and handoff.
Overview
sf-diagram-mermaid is an agent skill most often used in Build (also Validate scope, Ship review) that produces Mermaid flowcharts for Salesforce Agentforce agent structure and conversation flows.
Install
npx skills add https://github.com/jaganpro/sf-skills --skill sf-diagram-mermaidWhat is this skill?
- Mermaid flowchart template with Agentforce-specific subgraphs (topics, instructions, per-topic actions)
- Documents Apex and Flow actions with icons in architecture diagrams
- Supports planning conversation flows and escalation paths before build
- Useful for architecture reviews and stakeholder alignment on agent scope
Adoption & trust: 1.2k installs on skills.sh; 418 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are configuring or pitching an Agentforce agent but stakeholders cannot see how topics, instructions, and actions connect.
Who is it for?
Salesforce-focused builders documenting or planning Agentforce customer-service or order-management style agents before or during implementation.
Skip if: Teams that need runnable integrations, non-Salesforce agent stacks, or automated diagram generation from live org metadata without manual editing.
When should I use this skill?
Documenting Agentforce agent structure, planning agent topics and actions, visualizing conversation flows, or running architecture reviews.
What do I get? / Deliverables
You get copy-paste Mermaid diagrams that show service-agent layout, topic scopes, and action types so you can align scope and proceed to Agentforce configuration or review.
- Mermaid flowchart source for agent structure
- Per-topic subgraphs with scoped actions (Apex/Flow)
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Agentforce topology is built in Build, but the skill is used whenever you need a shared visual of topics, instructions, and Apex/Flow actions before or during implementation. agent-tooling is the canonical shelf because the templates map directly to Agentforce agents, topics, and action wiring—not generic app UI.
Where it fits
Sketch Order Status, Returns, and Escalation topics with Apex/Flow actions before committing to an Agentforce build.
Document the live agent’s instructions and per-topic action map for the team implementing Salesforce metadata.
Embed Mermaid architecture in internal docs so support and engineering share one view of the agent.
Attach a conversation-flow diagram to a launch or change review to show escalation and knowledge-base usage rules.
How it compares
Architecture documentation template for Agentforce—not a deployment skill or a generic whiteboard tool.
Common Questions / FAQ
Who is sf-diagram-mermaid for?
Solo and indie builders (and small teams) working on Salesforce Agentforce who need clear architecture and conversation-flow diagrams for reviews and planning.
When should I use sf-diagram-mermaid?
Use it in Validate when scoping agent topics and escalation; in Build when documenting agent-tooling structure; and in Ship review when explaining conversation flows to reviewers—whenever Agentforce structure needs a visual, not only at first build.
Is sf-diagram-mermaid safe to install?
It is a documentation template skill with no stated privileged access; review the Security Audits panel on this Prism page and inspect the skill files in your repo before installing.
SKILL.md
READMESKILL.md - Sf Diagram Mermaid
# Agentforce Flow Diagram Template Flowchart template for visualizing Agentforce agent architecture and conversation flows. ## When to Use - Documenting Agentforce agent structure - Planning agent topics and actions - Visualizing conversation flows - Architecture reviews ## Mermaid Template - Agent Structure ```mermaid %%{init: {"flowchart": {"nodeSpacing": 80, "rankSpacing": 70}} }%% flowchart TB subgraph agent["🤖 SERVICE AGENT"] direction TB DESC[/"Agent Description:<br/>AI-powered customer service<br/>assistant for order management"/] subgraph topics["📋 TOPICS"] direction LR T1[Order Status] T2[Return Request] T3[Product Info] T4[Escalation] end subgraph instructions["📝 INSTRUCTIONS"] I1[Greet professionally] I2[Verify customer identity] I3[Use knowledge base first] I4[Escalate if frustrated] end end subgraph topic_order["📦 TOPIC: ORDER STATUS"] direction TB TO_DESC[/"Help customers check<br/>order and shipping status"/] TO_SCOPE[Scope: Order tracking,<br/>delivery estimates] subgraph to_actions["ACTIONS"] TO_A1[Get Order Details<br/>⚡ Apex] TO_A2[Check Shipping<br/>🔄 Flow] end end subgraph topic_return["🔄 TOPIC: RETURN REQUEST"] direction TB TR_DESC[/"Process return and<br/>refund requests"/] TR_SCOPE[Scope: Returns, refunds,<br/>exchanges] subgraph tr_actions["ACTIONS"] TR_A1[Create Case<br/>🔄 Flow] TR_A2[Generate Label<br/>⚡ Apex] TR_A3[Process Refund<br/>⚡ Apex] end end %% Connections T1 --> topic_order T2 --> topic_return TO_A1 --> ORDER_SVC[Order Service] TO_A2 --> SHIP_API[Shipping API] TR_A1 --> CASE_OBJ[(Case Object)] TR_A2 --> SHIP_API TR_A3 --> PAY_API[Payment API] %% Node Styling - Topics (violet-200) style T1 fill:#ddd6fe,stroke:#6d28d9,color:#1f2937 style T2 fill:#ddd6fe,stroke:#6d28d9,color:#1f2937 style T3 fill:#ddd6fe,stroke:#6d28d9,color:#1f2937 style T4 fill:#ddd6fe,stroke:#6d28d9,color:#1f2937 %% Node Styling - Actions (emerald-200) style TO_A1 fill:#a7f3d0,stroke:#047857,color:#1f2937 style TO_A2 fill:#a7f3d0,stroke:#047857,color:#1f2937 style TR_A1 fill:#a7f3d0,stroke:#047857,color:#1f2937 style TR_A2 fill:#a7f3d0,stroke:#047857,color:#1f2937 style TR_A3 fill:#a7f3d0,stroke:#047857,color:#1f2937 %% Node Styling - External (orange-200) style ORDER_SVC fill:#fed7aa,stroke:#c2410c,color:#1f2937 style SHIP_API fill:#fed7aa,stroke:#c2410c,color:#1f2937 style PAY_API fill:#fed7aa,stroke:#c2410c,color:#1f2937 style CASE_OBJ fill:#fde68a,stroke:#b45309,color:#1f2937 %% Node Styling - Descriptions (slate-200) style DESC fill:#e2e8f0,stroke:#334155,color:#1f2937 style TO_DESC fill:#e2e8f0,stroke:#334155,color:#1f2937 style TO_SCOPE fill:#e2e8f0,stroke:#334155,color:#1f2937 style TR_DESC fill:#e2e8f0,stroke:#334155,color:#1f2937 style TR_SCOPE fill:#e2e8f0,stroke:#334155,color:#1f2937 style I1 fill:#e2e8f0,stroke:#334155,color:#1f2937 style I2 fill:#e2e8f0,stroke:#334155,color:#1f2937 style I3 fill:#e2e8f0,stroke:#334155,color:#1f2937 style I4 fill:#e2e8f0,stroke:#334155,color:#1f2937 %% Subgraph Styling - 50-level fills with dashed borders style agent fill:#fdf2f8,stroke:#be185d,stroke-dasharray:5 style topics fill:#f5f3ff,stroke:#6d28d9,stroke-dasharray:5 style instructions fill:#f8fafc,stroke:#334155,stroke-dasharray:5 style topic_order fill:#f5f3ff,stroke:#6d28d9,stroke-dasharray:5 style to_actions fill:#ecfdf5,stroke:#047857,stroke-dasharray:5 style topic_return fill:#f5f3ff,stroke:#6d28d9,stroke-dasharray:5 style tr_actions fill:#ecfdf5,stroke:#047857,stroke-dasharray:5 ``` ## Mermaid Template - Conver