SKILL.md
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.
- 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