| 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
-
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
-
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
-
Generate Mermaid diagram as a code block
-
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)
