saleorOfficial·17 Agent Skills Included

storefront

Build and maintain a production-ready Saleor headless storefront with AI

Guides AI agents through building and maintaining a Next.js 16 Saleor storefront with product pages, checkout, payments, and multi-language routing. Eliminates guesswork around caching, GraphQL codegen, variant selection, and fork upgrades with 31 task-specific rules. Helps developers ship international e-commerce sites faster with verified, production-ready patterns.

1,597|885

↗

npx skills add saleor/storefront --all -g -y

Available:

Acts as an always-on router that tells the AI agent which task-specific rule file to load, enforces architecture rules like Server Components and design tokens, and defines the verification commands to run before declaring work done.

All Skills in This Repository (17)

Pure Emerald Level Indicators

📦 In Repo

saleor

react-patterns

Guide React component logic placement across render, effects, and handlers.

checkout-management

Debug Saleor checkout state lifecycle across client and server contexts.

filtering-system

Define server-side and client-side filtering architecture for product lists.

ui-components

Create reusable UI components with design tokens, Tailwind, and shadcn/ui primitives.

checkout-architecture

Document reusable checkout UI components for sign-in, address, and payment steps.

saleor-investigation

Inspect Saleor source code to trace GraphQL resolvers, data loaders, and Django models.

testing

Automate Vitest testing workflows for JavaScript and TypeScript projects.

tailwind-turbopack

Generate Tailwind CSS classes via data attributes when Turbopack fails.

writing-skills

Catalog and codify AI agent skills using SKILL.md, REFERENCE.md, and STATE_MACHINE.md.

pdp

Implement Product Detail Pages with server and client component orchestration.

graphql-workflow

Synchronize GraphQL schemas with generated TypeScript types via graphql-codegen.

seo-system

Integrate page metadata, JSON-LD, and Open Graph/Twitter cards into Next.js applications.

Official

Intermediate

Frequently Asked Questions

FAQPage Schema

How to install Saleor Storefront skills?▼

Run `npx skills add saleor/storefront --all -g -y` in your terminal to install all skills in this suite globally.

What is the Saleor Paper storefront?▼

It is a production-ready, open-source headless e-commerce template built on Next.js 16, TypeScript, Tailwind CSS, and the Saleor GraphQL API. It includes checkout, product pages, multi-language routing, and SEO out of the box.

How do AI agents work with this repository?▼

The root AGENTS.md routes your agent to one of 31 task-specific rule files covering caching, checkout, variants, and design. This keeps context small and ensures the agent follows the project's exact architecture.

Can I upgrade my forked Saleor storefront automatically?▼

Yes. The paper-migrations skill reads a manifest of upstream changes and ports architecture updates into your fork without overwriting your custom styling.

Does it support multiple languages and currencies?▼

Yes. It ships with seven locales, locale-and-channel URL routing, per-channel pricing, translated catalog slugs, and hreflang SEO metadata.