saleor-configurator — Claude Code skill: Saleor config as code
Teaches your agent to write config.yml for a Saleor store and run deploy, introspect and diff without mixing up entity identifiers.
npx skills add saleor/agent-skills --skill saleor-configurator -a claude-codeWhat saleor-configurator does
Saleor Configurator is a CLI that describes a store's configuration in YAML and applies it declaratively. This skill hands the agent the rules behind that schema: the top-level keys, what an entity block looks like, which commands and flags the CLI takes, how credentials are set and how to run non-interactively.
Five rule files ship inside, ranked by priority. config-schema and identity-strategies are marked CRITICAL — the first covers the YAML structure, the second explains where a slug is required, where name works, and which entities are singletons. Then come cli-commands, deploy-pipeline with its stage order and failure handling, and diff-behavior, which describes what makes diff create, update or delete something.
Everything is also compiled into a single AGENTS.md. Reach for the skill when local config drifts from remote state, or when you're wiring up CI/CD and moving configuration between environments. Without it, the agent usually slips on identifiers first — worth reading identity-strategies before your first deploy.
What it helps with
- write a
config.ymlfor a Saleor store without schema mistakes - decide between
slugandnamefor a given entity - get the
deploystage order and failure handling right - find out why
diffreports extra creates or deletes - set up a non-interactive deploy for CI/CD
Example prompts for the agent
- Write a
config.ymlcovering our Saleor channels and warehouses - Why does
diffwant to delete a product that exists on the remote store? - Build a deploy pipeline that moves store config from staging to production
How to install saleor-configurator
1Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a claude-code2Manually: put the files in place
~/.claude/skills/saleor-configurator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/saleor-configurator/
1Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a codex2Manually: put the files in place
.agents/skills/saleor-configurator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a cursor2Manually: put the files in place
.cursor/skills/saleor-configurator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install saleor/agent-skills saleor-configurator2Manually: put the files in place
.github/skills/saleor-configurator/SKILL.md1Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a gemini-cli2Platform CLI
gemini skills install https://github.com/saleor/agent-skills --path skills/saleor-configuratorManually: put the files in place
.devin/skills/saleor-configurator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about saleor-configurator
How do I install saleor-configurator in Claude?
Run npx skills add saleor/agent-skills --skill saleor-configurator -a claude-code. The skill lands at ~/.claude/skills/saleor-configurator/SKILL.md.
What does saleor-configurator do?
It gives the agent Saleor Configurator patterns: writing the store's YAML config, running deploy, introspect and diff, picking the right entity identifier, and following the deployment stage order.
Which rules are included?
Five files: config-schema, identity-strategies, cli-commands, deploy-pipeline and diff-behavior. The first two are flagged CRITICAL, and the full set is compiled into AGENTS.md.
Source text
SKILL.md · MIT
--- 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`
© saleor · MIT · saleor/agent-skills
