Back to Skills

saleor-domain

verified

Provides comprehensive Saleor e-commerce domain knowledge including entity types, relationships, identifier rules, and GraphQL patterns. This skill should be invoked when the user needs to understand Saleor concepts, entity relationships, the difference between product-level and variant-level attributes, or how channels, warehouses, and shipping zones interact. Essential for understanding how Configurator maps to Saleor's data model.

View on GitHub

Marketplace

saleor-configurator

saleor/configurator

Plugin

saleor-configurator

Repository
Verified Org

saleor/configurator
22stars

plugin/skills/saleor-domain/SKILL.md

Last Verified

February 3, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/saleor/configurator/blob/main/plugin/skills/saleor-domain/SKILL.md -a claude-code --skill saleor-domain

Installation paths:

Claude
.claude/skills/saleor-domain/
Powered by add-skill CLI

Instructions

# Saleor Domain Knowledge

Saleor is a headless e-commerce platform built with Python/Django and GraphQL. This skill provides essential domain knowledge for configuring Saleor stores.

## Core Entities

### Channel

Channels represent sales channels (storefronts, marketplaces, regions). Each channel has its own:
- Currency
- Default country
- Product visibility and pricing
- Checkout and order settings

```yaml
channels:
  - name: "US Store"
    slug: "us-store"
    currencyCode: USD
    defaultCountry: US
```

### Product Type

Defines the structure of a product category with:
- Product-level attributes (shared across variants)
- Variant-level attributes (differ per variant)
- Shipping requirements
- Tax class

```yaml
productTypes:
  - name: "T-Shirt"
    isShippingRequired: true
    productAttributes:
      - name: "Brand"
    variantAttributes:
      - name: "Size"
      - name: "Color"
```

### Product & Variant

Products are the items you sell. Each product:
- Belongs to one product type
- Can be in multiple categories
- Has one or more variants (SKUs)

Variants represent purchasable items with:
- Unique SKU
- Specific attribute values
- Channel-specific pricing
- Inventory tracking

### Attribute

Attributes define product/variant characteristics:

| Attribute Level | Description | Example |
|----------------|-------------|---------|
| **Product** | Same for all variants | Brand, Material |
| **Variant** | Differs per variant | Size, Color |

### Category

Hierarchical product organization:
- Tree structure with parent/child relationships
- Products belong to leaf categories
- Used for navigation and filtering

### Collection

Curated product groupings:
- Can span multiple categories
- Manual or rule-based membership
- Used for promotions, featured sections

### Warehouse

Physical or virtual inventory locations:
- Stock tracking per warehouse
- Shipping zone associations
- Click & collect support

### Shipping Zone

Geographic shipping regions:
- Country-bas

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
5058 chars