# podo/design-agent-skills architecture

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

- Interactive diagram: https://gitdiagram.com/podo/design-agent-skills
- Repository: https://github.com/podo/design-agent-skills

## Overview

design-agent-skills is a curated, on-demand catalogue and installer for AI-agent design skills. Users can search or select a profile/category in the CLI, which delegates installation to the external `skills` command; agents can also follow catalogue routers from a broad design request to a domain router and then an implementation pointer. The README documents six domain catalogues and upstream retrieval, but sampled source only covers the CLI and catalogue-maintenance scripts, so router-to-skill links are shown only where the README explicitly describes them.

Main entry points: [`skills`](https://github.com/podo/design-agent-skills/tree/main/skills) (Implementation pointers), [`skills/design-catalogue/SKILL.md`](https://github.com/podo/design-agent-skills/blob/main/skills/design-catalogue/SKILL.md) (Design router), [`bin/cli.mjs`](https://github.com/podo/design-agent-skills/blob/main/bin/cli.mjs) (Catalogue CLI), [`skills/motion-catalogue/SKILL.md`](https://github.com/podo/design-agent-skills/blob/main/skills/motion-catalogue/SKILL.md) (Motion router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry"]
  node_cli["Catalogue CLI<br/>[cli.mjs]"]
end

subgraph group_routing["Skill routing"]
  node_design_router["Design router<br/>[SKILL.md]"]
  node_motion_router["Motion router<br/>[SKILL.md]"]
  node_figma_router["Figma router<br/>[SKILL.md]"]
  node_access_router["Accessibility router<br/>[SKILL.md]"]
  node_engineering_router["Engineering router<br/>[SKILL.md]"]
  node_content_router["Content router<br/>[SKILL.md]"]
end

subgraph group_catalogue["Skill catalogue"]
  node_skill_pointers["Implementation pointers"]
  node_upstream_skill["Full upstream skill"]
  node_add_wizard["Add-skill wizard<br/>[add-skill.mjs]"]
end

subgraph group_delivery["Installation"]
  node_skills_cli["skills command"]
  node_agent_dirs[("Agent skill directories")]
end

node_user(("User or agent"))

node_user -->|"searches or installs"| node_cli
node_cli -->|"reads catalogue"| node_skill_pointers
node_cli -->|"invokes install"| node_skills_cli
node_skills_cli -->|"installs pointers"| node_agent_dirs
node_user -->|"asks domain request"| node_design_router
node_design_router -->|"routes motion"| node_motion_router
node_design_router -->|"routes Figma"| node_figma_router
node_design_router -->|"routes accessibility"| node_access_router
node_design_router -->|"routes design engineering"| node_engineering_router
node_design_router -->|"routes content"| node_content_router
node_motion_router -.->|"selects implementation"| node_skill_pointers
node_figma_router -.->|"selects implementation"| node_skill_pointers
node_access_router -.->|"selects implementation"| node_skill_pointers
node_engineering_router -.->|"selects implementation"| node_skill_pointers
node_content_router -.->|"selects implementation"| node_skill_pointers
node_skill_pointers -->|"fetches full skill"| node_upstream_skill
node_add_wizard -->|"creates pointer files"| node_skill_pointers

click node_cli "https://github.com/podo/design-agent-skills/blob/main/bin/cli.mjs"
click node_design_router "https://github.com/podo/design-agent-skills/blob/main/skills/design-catalogue/SKILL.md"
click node_motion_router "https://github.com/podo/design-agent-skills/blob/main/skills/motion-catalogue/SKILL.md"
click node_figma_router "https://github.com/podo/design-agent-skills/blob/main/skills/figma-catalogue/SKILL.md"
click node_access_router "https://github.com/podo/design-agent-skills/blob/main/skills/accessibility-catalogue/SKILL.md"
click node_engineering_router "https://github.com/podo/design-agent-skills/blob/main/skills/design-engineering-catalogue/SKILL.md"
click node_content_router "https://github.com/podo/design-agent-skills/blob/main/skills/content-catalogue/SKILL.md"
click node_skill_pointers "https://github.com/podo/design-agent-skills/tree/main/skills"
click node_add_wizard "https://github.com/podo/design-agent-skills/blob/main/scripts/add-skill.mjs"

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_cli,node_user toneBlue
class node_design_router,node_motion_router,node_figma_router,node_access_router,node_engineering_router,node_content_router toneAmber
class node_skill_pointers,node_upstream_skill,node_add_wizard toneMint
class node_skills_cli,node_agent_dirs toneRose
```

## Components

### User entry

- [Catalogue CLI](https://github.com/podo/design-agent-skills/blob/main/bin/cli.mjs): `bin/cli.mjs`

### Skill routing

- [Design router](https://github.com/podo/design-agent-skills/blob/main/skills/design-catalogue/SKILL.md): `skills/design-catalogue/SKILL.md`
- [Motion router](https://github.com/podo/design-agent-skills/blob/main/skills/motion-catalogue/SKILL.md): `skills/motion-catalogue/SKILL.md`
- [Figma router](https://github.com/podo/design-agent-skills/blob/main/skills/figma-catalogue/SKILL.md): `skills/figma-catalogue/SKILL.md`
- [Accessibility router](https://github.com/podo/design-agent-skills/blob/main/skills/accessibility-catalogue/SKILL.md): `skills/accessibility-catalogue/SKILL.md`
- [Engineering router](https://github.com/podo/design-agent-skills/blob/main/skills/design-engineering-catalogue/SKILL.md): `skills/design-engineering-catalogue/SKILL.md`
- [Content router](https://github.com/podo/design-agent-skills/blob/main/skills/content-catalogue/SKILL.md): `skills/content-catalogue/SKILL.md`

### Skill catalogue

- [Implementation pointers](https://github.com/podo/design-agent-skills/tree/main/skills): `skills`
- **Full upstream skill**
- [Add-skill wizard](https://github.com/podo/design-agent-skills/blob/main/scripts/add-skill.mjs): `scripts/add-skill.mjs`

### Installation

- **skills command**
- **Agent skill directories**

### Other components

- **User or agent**

## Connections

- User or agent → Catalogue CLI: searches or installs (evidence: `README.md`)
- Catalogue CLI → Implementation pointers: reads catalogue (evidence: `README.md`)
- Catalogue CLI → skills command: invokes install (evidence: `bin/cli.mjs`)
- skills command → Agent skill directories: installs pointers (evidence: `README.md`)
- User or agent → Design router: asks domain request (evidence: `README.md`)
- Design router → Motion router: routes motion (evidence: `README.md`)
- Design router → Figma router: routes Figma (evidence: `README.md`)
- Design router → Accessibility router: routes accessibility (evidence: `README.md`)
- Design router → Engineering router: routes design engineering (evidence: `README.md`)
- Design router → Content router: routes content (evidence: `README.md`)
- Motion router → Implementation pointers: selects implementation
- Figma router → Implementation pointers: selects implementation
- Accessibility router → Implementation pointers: selects implementation
- Engineering router → Implementation pointers: selects implementation
- Content router → Implementation pointers: selects implementation
- Implementation pointers → Full upstream skill: fetches full skill (evidence: `README.md`)
- Add-skill wizard → Implementation pointers: creates pointer files (evidence: `scripts/add-skill.mjs`)
