# lubshad/skills architecture

> Architecture diagram of the GitHub repository lubshad/skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lubshad/skills
- Repository: https://github.com/lubshad/skills

## Overview

This repository is primarily a catalog of agent skills covering frontend, Flutter, Frappe, deployment, and project workflows, alongside operational scripts for Frappe configuration and Socket.IO proxy management. The likely user workflow is to select relevant guidance and apply it to a project; the supplied excerpts do not show the routing implementation or skill contents, so those relationships are left unverified. The two operational tools have clearer behavior in their excerpts. Validation scripts are catalog-maintenance infrastructure, not product runtime components.

Main entry points: [`skills`](https://github.com/lubshad/skills/tree/main/skills) (Skill Guidance), [`skills/routing-scenarios.json`](https://github.com/lubshad/skills/blob/main/skills/routing-scenarios.json) (Skill Routing), [`scripts/socketio_proxy_config.py`](https://github.com/lubshad/skills/blob/main/scripts/socketio_proxy_config.py) (Socket.IO Proxy Editor), [`scripts/sync_site_config.py`](https://github.com/lubshad/skills/blob/main/scripts/sync_site_config.py) (Site Config Sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill Catalog"]
  node_skill_catalog["Skill Guidance"]
  node_routing["Skill Routing"]
end

subgraph group_frontend["Frontend Guidance"]
  node_frontend_skills["Frontend Skills"]
  node_nextjs_skills["Next.js Skills"]
end

subgraph group_platform["Platform Guidance"]
  node_flutter_skills["Flutter Skills"]
  node_frappe_skills["Frappe Skills"]
end

subgraph group_operations["Operations Tools"]
  node_deployment_skills["Deployment Skills"]
  node_socket_config["Socket.IO Proxy Editor"]
  node_site_config["Site Config Sync"]
end

node_user(("Engineer"))
node_nginx_config["Nginx Config"]
node_site_files["Site Config Files"]

node_user -.->|"selects guidance"| node_routing
node_routing -.->|"routes to"| node_skill_catalog
node_skill_catalog -.->|"provides guidance"| node_frontend_skills
node_skill_catalog -.->|"provides guidance"| node_nextjs_skills
node_skill_catalog -.->|"provides guidance"| node_flutter_skills
node_skill_catalog -.->|"provides guidance"| node_frappe_skills
node_skill_catalog -.->|"provides guidance"| node_deployment_skills
node_user -->|"supplies config"| node_socket_config
node_socket_config -->|"reads and writes"| node_nginx_config
node_user -->|"selects action"| node_site_config
node_site_config -->|"reads and writes"| node_site_files

click node_skill_catalog "https://github.com/lubshad/skills/tree/main/skills"
click node_routing "https://github.com/lubshad/skills/blob/main/skills/routing-scenarios.json"
click node_frontend_skills "https://github.com/lubshad/skills/tree/main/skills/frontend-listing-screens"
click node_nextjs_skills "https://github.com/lubshad/skills/tree/main/skills/nextjs-architecture"
click node_flutter_skills "https://github.com/lubshad/skills/tree/main/skills/flutter-architecture"
click node_frappe_skills "https://github.com/lubshad/skills/tree/main/skills/frappe-python"
click node_deployment_skills "https://github.com/lubshad/skills/tree/main/skills/frappe-deployment"
click node_socket_config "https://github.com/lubshad/skills/blob/main/scripts/socketio_proxy_config.py"
click node_site_config "https://github.com/lubshad/skills/blob/main/scripts/sync_site_config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill_catalog,node_routing toneBlue
class node_frontend_skills,node_nextjs_skills toneAmber
class node_flutter_skills,node_frappe_skills toneMint
class node_deployment_skills,node_socket_config,node_site_config toneRose
class node_user,node_nginx_config,node_site_files toneIndigo
```

## Components

### Skill Catalog

- [Skill Guidance](https://github.com/lubshad/skills/tree/main/skills): `skills`
- [Skill Routing](https://github.com/lubshad/skills/blob/main/skills/routing-scenarios.json): `skills/routing-scenarios.json`

### Frontend Guidance

- [Frontend Skills](https://github.com/lubshad/skills/tree/main/skills/frontend-listing-screens): `skills/frontend-listing-screens`
- [Next.js Skills](https://github.com/lubshad/skills/tree/main/skills/nextjs-architecture): `skills/nextjs-architecture`

### Platform Guidance

- [Flutter Skills](https://github.com/lubshad/skills/tree/main/skills/flutter-architecture): `skills/flutter-architecture`
- [Frappe Skills](https://github.com/lubshad/skills/tree/main/skills/frappe-python): `skills/frappe-python`

### Operations Tools

- [Deployment Skills](https://github.com/lubshad/skills/tree/main/skills/frappe-deployment): `skills/frappe-deployment`
- [Socket.IO Proxy Editor](https://github.com/lubshad/skills/blob/main/scripts/socketio_proxy_config.py): `scripts/socketio_proxy_config.py`
- [Site Config Sync](https://github.com/lubshad/skills/blob/main/scripts/sync_site_config.py): `scripts/sync_site_config.py`

### Other components

- **Engineer**
- **Nginx Config**
- **Site Config Files**

## Connections

- Engineer → Skill Routing: selects guidance
- Skill Routing → Skill Guidance: routes to
- Skill Guidance → Frontend Skills: provides guidance
- Skill Guidance → Next.js Skills: provides guidance
- Skill Guidance → Flutter Skills: provides guidance
- Skill Guidance → Frappe Skills: provides guidance
- Skill Guidance → Deployment Skills: provides guidance
- Engineer → Socket.IO Proxy Editor: supplies config (evidence: `scripts/socketio_proxy_config.py`)
- Socket.IO Proxy Editor → Nginx Config: reads and writes (evidence: `scripts/socketio_proxy_config.py`)
- Engineer → Site Config Sync: selects action (evidence: `scripts/sync_site_config.py`)
- Site Config Sync → Site Config Files: reads and writes (evidence: `scripts/sync_site_config.py`)