spree-performance

Diagnose and resolve performance bottlenecks in Spree Commerce applications.

4|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/spree/agent-skills --skill spree-performance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spree-performance
Source: https://github.com/spree/agent-skills/tree/main/skills/spree-performance
Command: npx skills add https://github.com/spree/agent-skills --skill spree-performance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides the necessary tools and guidance to diagnose and improve the performance of Spree Commerce applications, addressing issues such as slow product listings, cart updates, search latency, image processing bottlenecks, and Sidekiq queue tuning.

Core Features & Use Cases

  • Performance Analysis: Identify performance hotspots in Spree applications.
  • Cart Pipeline Optimization: Optimize the cart recalculate service to reduce load and improve response times.
  • Catalog Rendering: Address N+1 queries in product listings and implement efficient preloading strategies.
  • Search Provider Tuning: Optimize search performance with database or Meilisearch configurations.
  • Image Processing: Optimize image generation and processing for efficient upload and rendering.
  • Sidekiq Queue Management: Configure Sidekiq queues to balance workload and prevent backlogs.
  • Admin Product Table: Address N+1 queries in the admin product table for efficient data handling.
  • Caching Strategies: Implement caching patterns to improve storefront performance.
  • Profiling Tools: Utilize profiling tools like rack-mini-profiler, bullet, and APM services for monitoring and optimization.
  • Use Case: If your Spree store experiences slow loading times or inefficient background processing, this Skill can help you pinpoint and resolve these issues.

Quick Start

Use the spree-performance skill to analyze the performance of your Spree store and identify bottlenecks.

Frequently Asked Questions about spree-performance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose slow product listings and cart updates in Spree Commerce?

To diagnose slow Spree Commerce performance, utilize profiling tools like rack-mini-profiler, bullet, and APM services to pinpoint N+1 queries in catalog rendering and bottlenecks in cart recalculate services.

How do I fix N+1 queries in Spree admin product tables and storefront listings?

Fix N+1 queries in Spree storefront and admin product tables by implementing efficient preloading strategies and database indexing to ensure product data renders without excessive database calls.

What's the best way to configure Sidekiq queues to prevent backlogs in Spree?

The best way to prevent Sidekiq queue backlogs in Spree is to configure queue weights and worker concurrency to balance image processing and background workload distribution efficiently.

How do I optimize Spree image processing and generation for faster storefront rendering?

Optimize Spree image processing by configuring efficient image generation pipelines and preloading strategies to reduce upload latency and improve storefront rendering response times.

Can I use Meilisearch to reduce search latency in my Spree Commerce store?

Yes, you can reduce search latency by tuning search provider configurations in Spree Commerce using Meilisearch or optimized database queries to deliver faster storefront search results.

Is this performance optimization suitable for medium-to-large Spree stores?

Yes, these performance optimization strategies and profiling tools specifically target medium-to-large Spree stores experiencing slow loading times and inefficient background processing workloads.