sight

name	sight
description	Use when the user says 'draw', 'diagram', 'visualize', 'architecture', or needs a visual overview of code structure.
version	1.0.0

👁️ Sight — The Hidden Becomes Clear

Generate Mermaid diagrams showing project architecture, schema, and data flow.

Activation

When this skill activates, output:

👁️ Sight — The hidden becomes clear.

Then execute the protocol below.

Context Guard

Context	Status
User asks for a diagram or visualization	ACTIVE — generate diagram
User says "draw", "diagram", "architecture"	ACTIVE — generate diagram
User asks to "show" or "map" the structure	ACTIVE — generate diagram
Discussing diagrams conceptually	DORMANT — do not activate
User is looking at existing diagrams	DORMANT — do not activate

Protocol

1. Determine diagram type from context:

   • "database" / "schema" → erDiagram
   • "api" / "endpoints" → flowchart TD
   • "components" / "pages" → graph TD
   • "architecture" / "structure" → flowchart TD (system overview)
   • "flow" / "process" → sequenceDiagram

2. Scan the relevant code:

   • For DB: read migration files in database/
   • For API: list files in src/app/api/
   • For pages: list files in src/app/
   • For architecture: read package.json, directory structure, configs

3. Generate Mermaid diagram as a code block

4. Optionally save to docs/diagrams/{name}.mermaid

Inputs

• What to visualize (database, API, components, architecture)
• Project directory

Outputs

• Mermaid diagram code block ready to render
• Optional saved .mermaid file

Example Usage

User: "draw the AdminStack database schema"

👁️ Sight — The hidden becomes clear.

​```mermaid
erDiagram
    accounts ||--o{ organizations : "has"
    accounts ||--o{ cc_sessions : "tracks"
    organizations ||--o{ projects : "contains"
    organizations ||--o{ contacts : "stores"
    organizations ||--o{ orders : "processes"

    accounts {
        uuid id PK
        text email
        boolean is_platform_admin
    }
    cc_sessions {
        uuid id PK
        text name
        text status
    }
​```

Level History

• Lv.1 — Base: Mermaid diagram generation from codebase analysis. (Origin: MemStack v1.0, Feb 2026)
• Lv.2 — Enhanced: Added YAML frontmatter, context guard, activation message, diagram type detection. (Origin: MemStack v2.0 MemoryCore merge, Feb 2026)