Storefront Best Practices
ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, payment flows, product pages, product listings, navigation, homepage, or ANY page/component in a storefront. CRITICAL for adding checkout, implementing cart, integrating Medusa backend, making a store agent-friendly for AI shopping agents, or building any ecommerce functionality. Framework-agnostic (Next.js, SvelteKit, TanStack Start, React, Vue). Provides patterns, decision frameworks, backend integration guidance.
Install
/plugin marketplace add medusajs/medusa-agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add medusajs/medusa-agent-skills --skill storefront-best-practicesgit clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git /tmp/medusa-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/medusa-agent-skills/plugins/ecommerce-storefront/skills/storefront-best-practices ~/.claude/skills/storefront-best-practicesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Ecommerce Storefront Best Practices Comprehensive guidance for building modern, high-converting ecommerce storefronts covering UI/UX patterns, component design, layout structures, SEO optimization, and mobile responsiveness. ## When to Apply **ALWAYS load this skill when working on ANY storefront task:** - **Adding checkout page/flow** - Payment, shipping, order placement - **Implementing cart** - Cart page, cart popup, add to cart functionality - **Building product pages** - Product details, product listings, product grids - **Creating navigation** - Navbar, megamenu, footer, mobile menu - **Integrating Medusa backend** - SDK setup, cart, products, payment - **Any storefront component** - Homepage, search, filters, account pages - Building new ecommerce storefronts from scratch - Improving existing shopping experiences and conversion rates - Optimizing for usability, accessibility, and SEO - Designing mobile-responsive ecommerce experiences - Making a storefront agent-friendly (AI shopping agents, AI search, agentic commerce) **Example prompts that should trigger this skill:** - "Add a checkout page" - "Implement shopping cart" - "Create product listing page" - "Connect to Medusa backend" - "Add navigation menu" - "Build homepage for store" - "Make my store agent-ready / AI-friendly" ## CRITICAL: Load Reference Files When Needed **⚠️ ALWAYS load `reference/design.md` BEFORE creating ANY UI component**
Details
- Skill name
storefront-best-practices- Repository
- medusajs/medusa-agent-skills
- Path
plugins/ecommerce-storefront/skills/storefront-best-practices/SKILL.md- Repo updated
- 13 November 2026
FAQ
What does the Storefront Best Practices skill do?
ALWAYS use this skill when working on ecommerce storefronts, online stores, shopping sites. Use for ANY storefront component including checkout pages, cart, payment flows, product pages, product listings, navigation, homepage, or ANY page/component in a storefront. CRITICAL for adding checkout, implementing cart, integrating Medusa backend, making a store agent-friendly for AI shopping agents, or building any ecommerce functionality. Framework-agnostic (Next.js, SvelteKit, TanStack Start, React, Vue). Provides patterns, decision frameworks, backend integration guidance.
How do I install the Storefront Best Practices skill?
Claude Code plugin: /plugin marketplace add medusajs/medusa-agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Storefront Best Practices popular?
It lives in medusajs/medusa-agent-skills, which has 237 GitHub stars and 29 forks.
Related skills
Building Admin Dashboard Customizations
237medusajs/medusa-agent-skills
Load automatically when planning, researching, or implementing Medusa Admin dashboard UI (widgets, custom pages, forms, tables, data loading, navigation). REQUIRED for all admin UI work in ALL modes (planning, implementation, exploration). Contains design patterns, component usage, and data loading patterns that MCP servers don't provide.
Building Storefronts
237medusajs/medusa-agent-skills
Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching). REQUIRED for all storefront development in ALL modes (planning, implementation, exploration). Contains SDK usage patterns, frontend integration, and critical rules for calling Medusa APIs.
Building with Medusa
237medusajs/medusa-agent-skills
Load automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links, business logic). REQUIRED for all Medusa backend work in ALL modes (planning, implementation, exploration). Contains architectural patterns, best practices, and critical rules that MCP servers don't provide.
Vlmkit
423mizchi/skills
Verify frontend changes with @mizchi/vlmkit: compare rendered HTML or screenshots, manage visual baselines, and inspect layout, accessibility or interaction defects. Use after visible UI changes or for a requested visual audit. Choose deterministic checks first, then use model-assisted modes when the task requires them.
React Expert
423mizchi/skills
React specialist perspective for the weekly review. Focuses on hooks discipline, re-rendering, Suspense / RSC, and Context design. Opinionated on React idioms.
Wordpress Router
211Automattic/agent-skills
Use when the user asks about WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts) and you need to quickly classify the repo and route to the correct workflow/skill (blocks, theme.json, REST API, WP-CLI, performance, security, testing, release packaging).
Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.