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)