visual-communicator
Enforces Visual Communication Standards. Use this skill when explaining complex logic, architectures, workflows, or when the user asks for diagrams.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Visual Communicator Skill
Purpose
To ensure that complex ideas are always accompanied by visual representations using Mermaid diagrams, adhering to the standard defined in GEMINI.md.
Trigger Conditions
- User asks for an explanation of code, architecture, or flow.
- You are writing a
specorimplementation_plan. - User explicitly asks for a diagram.
Decision Logic: Which Diagram?
| Scenario | Diagram Type | Syntax |
|---|---|---|
| Logic/Process/Decision Tree | Flowchart | graph TD |
| API Calls/Protocol/Interactions | Sequence | sequenceDiagram |
| Data Models/Classes/DB Schema | Class | classDiagram |
| State Changes/Lifecycle | State | stateDiagram-v2 |
| Timeline/Roadmap | Gantt | gantt |
Execution Rules
- Always Visualize: Do not just explain with text; show it with a diagram first.
-
Syntax Safety:
- Quote labels with special chars:
id["Label (Info)"]. - Avoid HTML in labels if possible.
- Quote labels with special chars:
-
Context Placement:
- If writing an Artifact (markdown), embed the diagram directly.
- If chatting, provide the diagram in the chat response.
Example Templates
Flowchart
graph TD
A[Start] --> B{Condition?}
B -- Yes --> C[Process]
B -- No --> D[End]
Sequence
sequenceDiagram
participant U as User
participant S as Server
U->>S: Request
S-->>U: Response
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!