Saleor Skills
Пять скиллов Saleor для агента: приложения, витрина, конфигуратор магазина как кода и внутреннее устройство бэкенда
- 112 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скиллы содержат инструкции и справочники, сами ничего не запускают
- Рекомендации касаются работы с платежными приложениями, поэтому код стоит проверять перед выкладкой
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/saleor-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скиллы содержат инструкции и справочники, сами ничего не запускают
- Рекомендации касаются работы с платежными приложениями, поэтому код стоит проверять перед выкладкой
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Папка skills в репозитории документации Saleor содержит пять скиллов, которые поддерживают вместе с документацией. Скилл `saleor-app` описывает протокол приложений: манифест, регистрацию, вебхуки, аутентификацию, платежные приложения, хранение настроек и встраивание в Dashboard. Скилл `saleor-storefront` рассказывает про модель данных GraphQL API, права, этапы оформления заказа, каналы и варианты товаров. Скилл `storefront-builder` задает контракты данных и поведение витрины пошагово, шаги запускаются по номеру. Скилл `saleor-configurator` учит описывать конфигурацию магазина в config.yml и выкатывать ее командами `deploy`, `introspect` и `diff`. Скилл `saleor-core` разбирает поведение бэкенда по исходникам: приоритеты скидок, распределение скидки заказа по строкам, режимы наличия товара на складе, срабатывание вебхуков и подводные камни миграций. У скиллов есть правила и справочники с приоритетами по важности: в `saleor-app` протокол, права и платежи помечены как критичные. Установка выполняется командой `npx skills add . --skill имя` из клона репозитория. Сборка документации также публикует список /.well-known/agent-skills/index.json со ссылками на скачиваемые скиллы.
Для кого. Разработчики на платформе Saleor, которые пишут приложения, витрины или конфигурацию магазина вместе с агентом.
Подходит, если
- Вы пишете приложение Saleor и нужны манифест, вебхуки и права доступа без ошибок протокола
- Строите витрину на Next.js, Remix или Nuxt и хотите единые правила работы с каналами, вариантами и оформлением заказа
- Ведете магазин как код: config.yml с командами `deploy`, `introspect` и `diff`
- Разбираете, почему скидка или ваучер не применилась, или отладите вебхуки PRODUCT_VARIANT_*_IN_CHANNEL
Не подходит, если
- Магазин работает не на Saleor: правила привязаны к его GraphQL API и бэкенду
- Нужна справка по общей документации продукта: скиллы покрывают пять тем, остальной сайт docs.saleor.io в них не вошел
- Вы хотите готовый плагин с автоматической установкой: установка идет из клона командой npx skills add
Пример запроса к агенту
Создай платежное приложение Saleor на Next.js: манифест, вебхуки транзакций и хранение настроек в метаданных, по правилам скилла `saleor-app`.Ограничения
Скиллы импортированы из репозитория saleor/agent-skills на коммите fb1a572 и дальше поддерживаются здесь. Для каждого скилла нужна отдельная установка командой с флагом --skill. Часть правил сверена с версиями Saleor 3.23 и новее, например режимы наличия товара. Лицензия репозитория документации в метаданных GitHub не определена, скиллы объявляют лицензию MIT в своих файлах, исходная лицензия лежит в skills/LICENSE.
Как отключить. Удалите папку нужного скилла из каталога скиллов вашего агента, например .claude/skills/saleor-app. Репозиторий документации ставить целиком не требуется, поэтому других следов нет.
Частые вопросы
Как поставить скиллы Saleor в Claude Code?
Склонируйте saleor-docs и выполните внутри `npx skills add . --skill saleor-app`. Имя скилла замените на `saleor-storefront`, `storefront-builder`, `saleor-configurator` или `saleor-core`.
Какие скиллы входят в набор?
Пять: `saleor-app`, `saleor-storefront`, `storefront-builder`, `saleor-configurator` и `saleor-core`. Таблица с назначением каждого лежит в skills/README.md.
Чем `saleor-core` отличается от `saleor-storefront`?
`saleor-core` описывает внутреннюю логику бэкенда: скидки, склад, вебхуки и миграции. `saleor-storefront` дает правила работы с публичным GraphQL API для витрин.
Нужно ли отдельно скачивать репозиторий saleor/agent-skills?
Нет. В документации сказано, что полные исходные каталоги скиллов импортированы сюда, и скачивать прежний репозиторий не нужно.
Что делает `saleor-configurator`?
Скилл объясняет, как вести конфигурацию магазина в config.yml и применять ее командами `deploy`, `introspect` и `diff`, а также как выбирать идентификатор slug или name для каждой сущности.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыWorkOS Skills — AuthKit, SSO и RBAC для агентов
WorkOS Skills
Официальные скиллы WorkOS: роутер и 40 справочников по AuthKit, SSO, Directory Sync, RBAC, Vault и миграциям с Auth0 и Clerk
Официальные скиллы Clerk учат агента подключать аутентификацию к Next.js, React, Vue, Expo, Swift и Android
Сотни скиллов по провайдерам учат агента принимать вебхуки, проверять подписи и разбирать события; примеры для Express и FastAPI.
Scalar API Reference — скилл для агентов
Scalar API Reference skill
Скилл подключает справочник Scalar к приложению по описанию OpenAPI: интеграции, аутентификация, темы и миграция со Swagger UI
builder-skills — скиллы для приложений на Convex
builder-skills
17 скиллов учат агента писать приложения на Convex по документации и вести проект через PRD, task.md и журнал изменений
Официальный набор устанавливаемых скиллов Oracle для работы с Oracle Database, OCI, GraalVM, Fusion и APEX
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Saleor Skills (эта карточка) | да | 112 | |
| Medusa Agent Skills | да | 236 | плагины для платформы Medusa, а здесь скиллы для Saleor |
| Shopify Admin Skills | нет | 204 | скиллы для Admin API Shopify, у Saleor другая модель данных и GraphQL API |
Коротко о README
Основной README относится к документации Saleor: она собирается на Blume и выкладывается на Vercel, страницы лежат в docs, схему API обновляет скрипт update-schema. О скиллах там сказано одной строкой со ссылкой на skills/README.md, где перечислены пять скиллов и способ установки.
Бейдж для README
Исходный SKILL.md
--- name: saleor-app description: > Universal Saleor app development patterns. Covers the app protocol (manifest, registration, webhooks, authentication), payment processing, SDK abstractions, settings persistence, and Dashboard integration. Framework-agnostic with Next.js examples. license: MIT metadata: author: saleor version: "1.0.0" --- # Saleor App Guide for building apps that extend Saleor via webhooks and the GraphQL API. Framework-agnostic protocol documentation with Next.js examples using `@saleor/app-sdk`. ## When to Apply - Defining an app manifest or registering webhooks - Handling async/sync webhook events from Saleor - Building payment apps with the Transaction API and provider webhooks - Authenticating requests (registration handshake, JWT, signature verification) - Storing app settings in Saleor metadata - Building Dashboard UI inside the iframe - Making GraphQL calls with app tokens - Debugging webhook failures, auth errors, or permission issues - Deciding who can view the app and what they should see (user vs app scope) ## Rule Categories by Priority | Priority | Category | Impact | Prefix | | -------- | --------------- | -------- | --------------- | | 1 | Protocol | CRITICAL | `protocol-` | | 2 | Permissions | CRITICAL | `permissions-` | | 3 | Payment Apps | CRITICAL | `payment-` | | 4 | Webhooks | HIGH | `webhook-` | | 5 | Data & Settings | HIGH | `data-` | | 6 | Dashboard UI | MEDIUM | `dashboard-` | | 7 | Development | MEDIUM | `dev-` | ## Quick Reference ### 1. Protocol (CRITICAL)