saleor/saleor-storefront
skills/saleor-storefront/SKILL.md
Saleor e-commerce API patterns for building storefronts. Use when working with Saleor's GraphQL API, products, variants, checkout, channels, permissions, or debugging API behavior. Framework-agnostic — applies to any Saleor storefront.
development
Updated May 6, 2026
$ install --global
skillsauthnpx skillsauth add saleor/agent-skills saleor-storefrontInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 6, 2026, 5:17 AM59.8s11 files scanned
SKILL.md
- name:
- saleor-storefront
- description:
- >
- license:
- MIT
- author:
- saleor
- version:
- 1.0.0
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.md
Each 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
Related Skills
saleor/saleor-core
tools
VerifiedTrustedCommunity
Saleor backend internals and behavior reference. Covers discount precedence, order-level discount allocation across lines (two-pass calculation, what the API does and doesn't expose, gift-line shape gotchas), stock availability modes (legacy vs direct, 3.23+), Dashboard UI rules, webhook trigger conditions, denormalized field semantics, and migration footguns. Use when working with Saleor discounts or stock availability, building Dashboard UI, building price-explanation tooling, or debugging backend behavior.
2SKILL.mdUpdated May 6, 2026
saleor/storefront-builder
development
VerifiedTrustedCommunity
Saleor storefront data + UX playbook. Covers GraphQL query design, channel handling, data contracts per surface (PLP/PDP/nav/pricing/availability/media), variant-selection UX, and Saleor-specific correctness rules. Framework-agnostic — agent inspects repo and applies conventions locally.
SKILL.mdUpdated May 6, 2026
saleor/saleor-configurator
development
VerifiedTrustedCommunity
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.
SKILL.mdUpdated May 6, 2026
saleor/saleor-app
development
VerifiedTrustedCommunity
Universal Saleor app development patterns. Covers the app protocol (manifest, registration, webhooks, authentication), SDK abstractions, settings persistence, and Dashboard integration. Framework-agnostic with Next.js examples.
SKILL.mdUpdated May 6, 2026