# shopify/shopify-ai-toolkit architecture

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

- Interactive diagram: https://gitdiagram.com/shopify/shopify-ai-toolkit
- Repository: https://github.com/shopify/shopify-ai-toolkit

## Overview

Shopify AI Toolkit is an agent plugin whose skills support Shopify app development and store operations. The main workflow starts with an agent invoking a domain skill, searching Shopify documentation or schemas, then validating generated GraphQL, Liquid, or extension code; store-management skills expose CLI-backed execution. Skill scripts also emit telemetry. README capabilities describe several skill families not sampled individually, so those are represented at their existing skill-directory paths; the OpenClaw entry explicitly registers no runtime capabilities.

Main entry points: [`skills`](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills) (Shopify skill catalog), [`skills/shopify-dev`](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-dev) (App development skills), [`skills/shopify-use-shopify-cli`](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-use-shopify-cli) (Store CLI skills), [`skills/shopify-admin/scripts/search_docs.mjs`](https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/search_docs.mjs) (Docs and schemas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Agent Skills"]
  node_skillset["Shopify skill catalog"]
  node_devskills["App development skills"]
  node_store_skills["Store CLI skills"]
  node_extension_skills["Extension skills"]
  node_domain_skills["Shopify domain skills"]
  node_openclaw["OpenClaw entry"]
end

subgraph group_dev["Developer Resources"]
  node_docs["Docs and schemas<br/>[search_docs.mjs]"]
  node_validation["Code validation<br/>[validate.mjs]"]
end

subgraph group_store["Store Operations"]
  node_cli["Shopify CLI"]
end

subgraph group_telemetry["Usage Telemetry"]
  node_telemetry_scripts["Skill telemetry scripts<br/>[log_feedback.mjs]"]
  node_usage_endpoint["Usage endpoint"]
end

node_agent(("AI agent"))
node_shopify_docs[("Shopify developer docs")]

node_agent -->|"invokes skills"| node_skillset
node_skillset -->|"dispatches"| node_devskills
node_skillset -->|"dispatches"| node_store_skills
node_devskills -->|"searches docs"| node_docs
node_docs -->|"fetches"| node_shopify_docs
node_agent -->|"validates code"| node_validation
node_agent -->|"invokes"| node_extension_skills
node_agent -->|"invokes"| node_domain_skills
node_agent -->|"requests store work"| node_store_skills
node_store_skills -->|"uses CLI"| node_cli
node_devskills -->|"logs usage"| node_telemetry_scripts
node_telemetry_scripts -->|"sends events"| node_usage_endpoint
node_openclaw -.->|"loads skills"| node_skillset

click node_skillset "https://github.com/shopify/shopify-ai-toolkit/tree/main/skills"
click node_devskills "https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-dev"
click node_store_skills "https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-use-shopify-cli"
click node_docs "https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/search_docs.mjs"
click node_validation "https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/validate.mjs"
click node_extension_skills "https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-polaris-checkout-extensions"
click node_domain_skills "https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-payments-apps"
click node_telemetry_scripts "https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/log_feedback.mjs"
click node_openclaw "https://github.com/shopify/shopify-ai-toolkit/blob/main/openclaw.extension.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_skillset,node_devskills,node_store_skills,node_extension_skills,node_domain_skills,node_openclaw toneBlue
class node_docs,node_validation,node_shopify_docs toneAmber
class node_cli toneMint
class node_telemetry_scripts,node_usage_endpoint toneRose
class node_agent toneIndigo
```

## Components

### Agent Skills

- [Shopify skill catalog](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills): `skills`
- [App development skills](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-dev): `skills/shopify-dev`
- [Store CLI skills](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-use-shopify-cli): `skills/shopify-use-shopify-cli`
- [Extension skills](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-polaris-checkout-extensions): `skills/shopify-polaris-checkout-extensions`
- [Shopify domain skills](https://github.com/shopify/shopify-ai-toolkit/tree/main/skills/shopify-payments-apps): `skills/shopify-payments-apps`
- [OpenClaw entry](https://github.com/shopify/shopify-ai-toolkit/blob/main/openclaw.extension.mjs): `openclaw.extension.mjs`

### Developer Resources

- [Docs and schemas](https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/search_docs.mjs): `skills/shopify-admin/scripts/search_docs.mjs`
- [Code validation](https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/validate.mjs): `skills/shopify-admin/scripts/validate.mjs`

### Store Operations

- **Shopify CLI**

### Usage Telemetry

- [Skill telemetry scripts](https://github.com/shopify/shopify-ai-toolkit/blob/main/skills/shopify-admin/scripts/log_feedback.mjs): `skills/shopify-admin/scripts/log_feedback.mjs`
- **Usage endpoint**

### Other components

- **AI agent**
- **Shopify developer docs**

## Connections

- AI agent → Shopify skill catalog: invokes skills
- Shopify skill catalog → App development skills: dispatches
- Shopify skill catalog → Store CLI skills: dispatches
- App development skills → Docs and schemas: searches docs
- Docs and schemas → Shopify developer docs: fetches
- AI agent → Code validation: validates code
- AI agent → Extension skills: invokes
- AI agent → Shopify domain skills: invokes
- AI agent → Store CLI skills: requests store work
- Store CLI skills → Shopify CLI: uses CLI
- App development skills → Skill telemetry scripts: logs usage
- Skill telemetry scripts → Usage endpoint: sends events
- OpenClaw entry → Shopify skill catalog: loads skills