# bergside/awesome-design-skills architecture

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

- Interactive diagram: https://gitdiagram.com/bergside/awesome-design-skills
- Repository: https://github.com/bergside/awesome-design-skills

## Overview

Awesome Design Skills is a curated registry of design-system guidance for AI coding agents. A user selects a skill with the documented `npx typeui.sh pull <skill>` command; the CLI pulls that skill into the user's project. Each skill includes agent-facing instructions and human-readable design rationale. The README documents this workflow, but no source excerpts are available to verify implementation details or how the index participates.

Main entry points: [`skills`](https://github.com/bergside/awesome-design-skills/tree/main/skills) (Design skill folders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Skill catalog"]
  node_index["Skill index<br/>[index.json]"]
  node_catalog_skills["Design skill folders"]
end

subgraph group_formats["Skill content"]
  node_agent_guidance["Agent instructions"]
  node_design_notes["Design rationale"]
end

subgraph group_users["Consumers"]
  node_agent_tools["AI agent tools"]
  node_project["User project"]
end

node_user(("Project user"))
node_cli["TypeUI pull CLI"]

node_user -->|"runs pull"| node_cli
node_cli -->|"pulls skill"| node_catalog_skills
node_catalog_skills -->|"copies into"| node_project
node_agent_guidance -->|"guides agents"| node_agent_tools
node_design_notes -->|"explains design"| node_project

click node_index "https://github.com/bergside/awesome-design-skills/blob/main/skills/index.json"
click node_catalog_skills "https://github.com/bergside/awesome-design-skills/tree/main/skills"
click node_agent_guidance "https://github.com/bergside/awesome-design-skills/tree/main/skills"
click node_design_notes "https://github.com/bergside/awesome-design-skills/tree/main/skills"

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_index,node_catalog_skills,node_user,node_cli toneBlue
class node_agent_guidance,node_design_notes toneAmber
class node_agent_tools,node_project toneMint
```

## Components

### Skill catalog

- [Skill index](https://github.com/bergside/awesome-design-skills/blob/main/skills/index.json): `skills/index.json`
- [Design skill folders](https://github.com/bergside/awesome-design-skills/tree/main/skills): `skills`

### Skill content

- [Agent instructions](https://github.com/bergside/awesome-design-skills/tree/main/skills): `skills`
- [Design rationale](https://github.com/bergside/awesome-design-skills/tree/main/skills): `skills`

### Consumers

- **AI agent tools**
- **User project**

### Other components

- **Project user**
- **TypeUI pull CLI**

## Connections

- Project user → TypeUI pull CLI: runs pull (evidence: `README.md`)
- TypeUI pull CLI → Design skill folders: pulls skill (evidence: `README.md`)
- Design skill folders → User project: copies into (evidence: `README.md`)
- Agent instructions → AI agent tools: guides agents (evidence: `README.md`)
- Design rationale → User project: explains design (evidence: `README.md`)
