# saleor-configurator

Guide to managing a Saleor store as code with config.yml, covering deploy and diff commands and how entities are matched.

Skill by Saleor. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add saleor/agent-skills --skill saleor-configurator
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add saleor/agent-skills --skill saleor-configurator -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 400. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/saleor/agent-skills/saleor-configurator)

## Source

[Open the source](https://github.com/saleor/agent-skills/tree/HEAD/skills/saleor-configurator). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: saleor-configurator
description: >
  Saleor Configurator patterns for managing store configuration as code. Use when
  writing config.yml, running deploy/introspect/diff commands, understanding entity
  identification (slug vs name), deployment pipeline order, or debugging sync issues.
license: MIT
metadata:
  author: saleor
  version: "1.0.0"
---

# Saleor Configurator

Guide for using Saleor Configurator — a "commerce as code" CLI that lets you define
your entire Saleor store configuration in YAML and deploy it declaratively.

## When to Apply

- Writing or editing `config.yml` for a Saleor store
- Running `deploy`, `introspect`, or `diff` commands
- Understanding which identifier to use (`slug` vs `name`) for each entity
- Debugging mismatches between local config and remote state
- Setting up CI/CD pipelines for automated deployments
- Migrating store configuration between environments

## Rule Categories by Priority

| Priority | Category           | Impact   | Prefix       |
| -------- | ------------------ | -------- | ------------ |
| 1        | Config Schema      | CRITICAL | `config-`    |
| 2        | Entity Identity    | CRITICAL | `identity-`  |
| 3        | CLI Workflow       | HIGH     | `cli-`       |
| 4        | Deployment         | HIGH     | `deploy-`    |
| 5        | Diff & Sync        | MEDIUM   | `diff-`      |

## Quick Reference

### 1. Config Schema (CRITICAL)

- `config-schema` — YAML structure, all top-level keys, entity examples

### 2. Entity Identity (CRITICAL)

- `identity-strategies` — Slug-based vs name-based vs singleton; which entity uses which

### 3. CLI Workflow (HIGH)

- `cli-commands` — All commands, flags, env vars, credential setup, non-interactive mode

### 4. Deployment (HIGH)

- `deploy-pipeline` — Stage order, dependency graph, selective deployment, failure handling

### 5. Diff & Sync (MEDIUM)

- `diff-behavior` — How diff detects changes, what triggers create/update/delete

## How to Use

Read individual rule files for detailed explanations and examples:

```
rules/config-schema.md
rules/identity-strategies.md
rules/cli-commands.md
rules/deploy-pipeline.md
rules/diff-behavior.md
```

## Full Compiled Document

For the complete guide with all rules expanded: `AGENTS.md`
````

- Previous: [saleor-core](https://syn4pse.dev/terminal/saleor-core.md)
- Next: [storefront-builder](https://syn4pse.dev/terminal/saleor-storefront-builder.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
