How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/saleor/agent-skills --skill saleor-storefrontBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Saleor Storefront
Universal guide for building storefronts on the Saleor e-commerce platform. Covers the Saleor GraphQL API data model, permission system, checkout lifecycle, channel architecture, and product/variant patterns. Framework-agnostic — these rules apply whether you're using Next.js, Remix, Nuxt, or a custom setup.
When to Apply
Reference these guidelines when:
- Querying Saleor's GraphQL API for products, categories, or collections
- Building product detail pages with variant selection
- Implementing checkout and payment flows
- Working with multi-channel and multi-currency setups
- Debugging "product not purchasable" or permission errors
- Working with Saleor 3.23+ stock availability modes (
useLegacyShippingZoneStockAvailability) - Investigating Saleor API behavior via source code
Rule Categories
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | API | CRITICAL | api- |
| 2 | Products | HIGH | products- |
| 3 | Checkout | HIGH | checkout- |
| 4 | Channels | MEDIUM | channels- |
Quick Reference
1. API (CRITICAL)
api-data-model— Nullable fields, pricing structure, automatic storefront filteringapi-permissions— Token types, permission errors, two-tier query patternapi-graphql-patterns— Channel-scoped queries, variant attributes, filtering, codegenapi-investigation— How to investigate Saleor API behavior via types and source
2. Products (HIGH)
products-variants— Variant model, selection vs non-selection attributes, pricing, UX patterns
3. Checkout (HIGH)
checkout-lifecycle— Session lifecycle, common errors, debugging payment issues
4. Channels (MEDIUM)
channels-purchasability— Stock availability modes (legacy vs direct, 3.23+), purchasability vs shippability, fulfillment triangle, mode-aware checklists, channel-scoped queries, stock webhooks
How to Use
Read individual rule files for detailed explanations and code examples:
rules/api-data-model.md
rules/products-variants.mdEach rule file contains:
- Brief explanation of why it matters
- Code examples (correct and incorrect patterns)
- Anti-patterns to avoid
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
