saleor-configurator — скилл для Claude Code: конфиг Saleor как код
Помогает агенту писать config.yml для магазина Saleor и гонять deploy, introspect, diff без путаницы в идентификаторах сущностей.
npx skills add saleor/agent-skills --skill saleor-configurator -a claude-codeЧто делает saleor-configurator
Saleor Configurator — CLI, который описывает конфигурацию магазина в YAML и раскатывает её декларативно. Скилл даёт агенту правила работы с этой схемой: какие ключи верхнего уровня бывают, как выглядит описание сущностей, какие команды и флаги есть у CLI, как задаются учётные данные и неинтерактивный режим.
Внутри пять файлов правил с приоритетами. config-schema и identity-strategies помечены как CRITICAL: первый разбирает структуру YAML, второй объясняет, где нужен slug, где name, а где сущность-синглтон. Дальше идут cli-commands, deploy-pipeline с порядком стадий и обработкой сбоев и diff-behavior — про то, что именно заставляет diff создать, обновить или удалить объект.
Есть и собранный целиком документ AGENTS.md. Скилл пригодится, когда локальный конфиг расходится с удалённым состоянием или когда вы настраиваете CI/CD и переносите конфигурацию между окружениями. Без него агент чаще всего ошибается именно на идентификаторах — это повод проверить identity-strategies до первого деплоя.
Какие задачи решает
- написать
config.ymlдля магазина Saleor без ошибок в схеме - выбрать между
slugиnameпри описании сущности - разобраться с порядком стадий в
deployи обработкой сбоев - понять, почему
diffпоказывает лишние create или delete - настроить неинтерактивный деплой в CI/CD
Примеры запросов агенту
- Опиши в
config.ymlканалы и склады для нашего магазина Saleor - Почему
diffпредлагает удалить товар, который есть на удалённом стенде? - Собери пайплайн деплоя конфигурации между staging и production
Как установить saleor-configurator
1Через Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a claude-code2Вручную: положить файлы
~/.claude/skills/saleor-configurator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/saleor-configurator/
1Через Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a codex2Вручную: положить файлы
.agents/skills/saleor-configurator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a cursor2Вручную: положить файлы
.cursor/skills/saleor-configurator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install saleor/agent-skills saleor-configurator2Вручную: положить файлы
.github/skills/saleor-configurator/SKILL.md1Через Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a gemini-cli2Командой платформы
gemini skills install https://github.com/saleor/agent-skills --path skills/saleor-configuratorВручную: положить файлы
.devin/skills/saleor-configurator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add saleor/agent-skills --skill saleor-configurator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора2
Похожие
Рядом в теме «DevOps и инфраструктура»
Всё по теме «DevOps и инфраструктура» →Вопросы о saleor-configurator
Как установить saleor-configurator в Claude?
Выполните npx skills add saleor/agent-skills --skill saleor-configurator -a claude-code. Файл скилла окажется по пути ~/.claude/skills/saleor-configurator/SKILL.md.
Что делает saleor-configurator?
Учит агента работать с Saleor Configurator: писать YAML-конфигурацию магазина, запускать deploy, introspect и diff, разбираться в идентификаторах сущностей и в порядке стадий деплоя.
Какие правила входят в скилл?
Пять файлов: config-schema, identity-strategies, cli-commands, deploy-pipeline и diff-behavior. Первые два помечены как CRITICAL, полная версия всех правил собрана в AGENTS.md.
Исходный текст
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
