Back to list
mr-phariyawit

visual-communicator

by mr-phariyawit

HonKaTack project

0🍴 0📅 Jan 22, 2026

SKILL.md


name: visual-communicator description: Enforces Visual Communication Standards. Use this skill when explaining complex logic, architectures, workflows, or when the user asks for diagrams.

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 spec or implementation_plan.
  • User explicitly asks for a diagram.

Decision Logic: Which Diagram?

ScenarioDiagram TypeSyntax
Logic/Process/Decision TreeFlowchartgraph TD
API Calls/Protocol/InteractionsSequencesequenceDiagram
Data Models/Classes/DB SchemaClassclassDiagram
State Changes/LifecycleStatestateDiagram-v2
Timeline/RoadmapGanttgantt

Execution Rules

  1. Always Visualize: Do not just explain with text; show it with a diagram first.
  2. Syntax Safety:
    • Quote labels with special chars: id["Label (Info)"].
    • Avoid HTML in labels if possible.
  3. 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

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon