Saleor Agent Skills

Universal agent skills for building e-commerce applications with Saleor.

Available Skills

Skill	Description
saleor-app	Patterns for building Saleor apps — protocol manifest, dashboard appbridge, webhooks, permissions
saleor-configurator	Patterns for managing Saleor store configuration as code using Saleor Configurator — config.yml schema, deploy/diff/introspect CLI, entity identity, deployment pipeline
saleor-core	Saleor backend internals — discount precedence, stacking rules, denormalized fields, Dashboard bugs
saleor-storefront	Saleor API patterns for building storefronts — data model, permissions, checkout, channels, variants

Installation

Install a specific skill with npx skills:

npx skills add saleor/agent-skills --skill <skill-name>

Where <skill-name> is one of: saleor-app, saleor-configurator, saleor-core, saleor-storefront. See each skill's README for its install command.

This installs the skill into .agents/skills/ in your project, where AI agents can auto-discover it.

What Are Agent Skills?

Agent skills are structured instruction sets that help AI coding assistants (like Cursor, Claude, Copilot) understand domain-specific patterns. They follow the Agent Skills Specification.

Each skill contains:

• SKILL.md — Overview and quick reference (agents read this first)
• AGENTS.md — Full compiled document with all rules expanded
• rules/ — Individual rule files with detailed examples
• references/ — Supporting deep-dive documentation

License

BSD-3-Clause AND CC-BY-4.0