saleor/saleor-core
skills/saleor-core/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add saleor/agent-skills saleor-coreInstall 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: Jun 12, 2026, 5:23 AM148.8s5 files scanned
SKILL.md
- name:
- saleor-core
- description:
- >
- license:
- MIT
- author:
- saleor
- version:
- 1.2.0
Saleor Core
Backend behavior reference derived from the Saleor core source code. Covers internal mechanics that aren't fully documented in the public API reference — discount precedence, stock availability modes, denormalized fields, and known Dashboard gotchas.
When to Apply
- Building or debugging discount/promotion UI in the Dashboard
- Investigating why a voucher or promotion isn't applying
- Understanding order-level vs line-level discount precedence
- Working with
OrderDiscount/OrderLineDiscountobjects - Debugging
unit_discount_valueonOrderLine - Deciding whether discounts stack or suppress each other
- Building price-explanation / waterfall tooling on confirmed orders
- Reconstructing how an order-level discount distributed across lines
- Handling free-gift order lines (
OrderLine.isGift = true) - Working on stock availability, shipping zones, warehouses, or
Shop.useLegacyShippingZoneStockAvailability - Debugging why
PRODUCT_VARIANT_*_IN_CHANNELwebhooks aren't firing - Building diagnostic / "doctor" tooling that explains availability problems
- Auditing Dashboard copy that uses "available" / "in stock" / "purchasable"
Rule Categories
| Priority | Category | Impact | Prefix |
| -------- | ---------- | -------- | ------------ |
| 1 | Discounts | CRITICAL | discount- |
| 2 | Stock | CRITICAL | stock- |
Quick Reference
1. Discounts (CRITICAL)
discount-precedence— Full precedence hierarchy, stacking rules, manual vs voucher vs promotion interactions, denormalized field semantics, known Dashboard bugorder-discount-allocation— Two-pass calculation of order-level discounts (Pass A collapses records into a single subtotal_discount; Pass B distributes proportionally across lines with last-line absorbing rounding), what the API exposes (per-line totals, per-record-at-order amounts) and what it doesn't (per-record-per-line decomposition), gift-line shape gotcha (ORDER_PROMOTIONonOrderLine.discounts[]whenisGift = true), reconstruction guidance for consumers
2. Stock (CRITICAL)
stock-availability-modes—Shop.useLegacyShippingZoneStockAvailability(3.23+), purchasability vs shippability, server queryset dispatch, mode-conditional webhooks, Dashboard UI / copy / severity rules, migration footguns, test fixtures
How to Use
Read individual rule files for detailed explanations and source-level evidence:
rules/discount-precedence.md
rules/order-discount-allocation.md
rules/stock-availability-modes.md
Each rule file contains:
- Precedence hierarchy or computation rules
- Source code references from
saleor/with function names and file paths - Anti-patterns and known bugs
Related Skills
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-storefront
development
VerifiedTrustedCommunity
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.
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