How do I install the Shopify Load Scale skill?

Run npx skillmds@latest add jeremylongshore/shopify-load-scale in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Shopify Load Scale safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Shopify Load Scale?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Shopify Load Scale free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Shopify Load Scale?

jeremylongshore (@jeremylongshore) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Shopify Load Scale by jeremylongshore

Name: Shopify Load Scale
Rating: 4.5 (4 reviews)
Author: jeremylongshore

Shopify Load Scale

'Load test Shopify integrations respecting API rate limits, plan capacity with k6, and scale for Shopify Plus burst events (flash sales, BFCM). Use when preparing for high-traffic events, benchmarking API throughput, or sizing infrastructure for Shopify webhook volume. Trigger with phrases like "shopify load test", "shopify scale", "shopify BFCM", "shopify flash sale", "shopify capacity", "shopify k6 test". '

File contents

Shopify Load & Scale

Overview

Load test Shopify app integrations while respecting API rate limits. Plan capacity for high-traffic events like Black Friday / Cyber Monday (BFCM).

Prerequisites

k6 load testing tool installed (brew install k6)
Test store with API access (never load test production)
Understanding of Shopify rate limits per plan

Instructions

Step 1: Understand Capacity Constraints

Your app's throughput is bounded by Shopify's rate limits, not your infrastructure:

Plan	GraphQL Points	Restore Rate	Max Sustained QPS	Burst Capacity
Standard	1,000	50/sec	~10 queries/sec	1,000 points burst
Shopify Plus	2,000	100/sec	~20 queries/sec	2,000 points burst

A typical product query costs 10-50 points. At 50 points/query, Standard supports ~1 query/second sustained.

Step 2: k6 Load Test Script

k6 script with Shopify-specific custom metrics (throttle tracking, query cost trends, error rates) and automatic request pacing.

See k6 Load Test Script for the complete test script.

Step 3: Run Load Test

# Against a test store — NEVER production
k6 run \
  --env SHOPIFY_STORE=dev-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_test_token \
  shopify-load-test.js

# Output results to InfluxDB for Grafana dashboards
k6 run --out influxdb=http://localhost:8086/k6 shopify-load-test.js

Step 4: BFCM / Flash Sale Preparation

Pre-BFCM preparation including cache pre-warming, Storefront API offloading, bulk inventory sync, and Kubernetes HPA configuration for webhook processing.

See BFCM Preparation for application-level and infrastructure scaling patterns.

Output

Load test script calibrated to Shopify rate limits
Performance baseline documented
BFCM preparation checklist completed
Infrastructure scaling configured for webhook volume

Error Handling

Issue	Cause	Solution
k6 shows high error rate	Hitting rate limits	Reduce VUs, increase sleep between requests
All requests THROTTLED	Exceeding 50 points/sec	Space queries further apart
Webhooks backing up	Slow processing	Respond 200 immediately, queue processing
Cache stampede on sale start	All caches expire at once	Stagger cache TTLs, pre-warm

Examples

Quick Capacity Estimate

# How many queries can you sustain?
# Standard plan: 50 points/sec restore
# Your query costs: check with debug header

curl -sf "https://$STORE/admin/api/${SHOPIFY_API_VERSION:-2025-04}/graphql.json" \
  -H "X-Shopify-Access-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Shopify-GraphQL-Cost-Debug: 1" \
  -d '{"query": "{ products(first: 10) { edges { node { id title } } } }"}' \
  | jq '"Query cost: \(.extensions.cost.actualQueryCost) points. Max sustained: \(50 / .extensions.cost.actualQueryCost) queries/sec"'

Resources

Source: jeremylongshore/claude-code-plugins-plus-skills → skills/.curated/shopify-load-scale/SKILL.md

Also appears in: jeremylongshore/claude-code-plugins-plus-skills/plugins/saas-packs/shopify-pack/skills/shopify-load-scale/SKILL.md

---name: shopify-load-scaledescription: 'Load test Shopify integrations respecting API rate limits, plan capacity with k6, and scale for Shopify Plus burst events (flash sales, BFCM). Use when preparing for high-traffic events, benchmarking API throughput, or sizing infrastructure for Shopify webhook volume. Trigger with phrases like "shopify load test", "shopify scale", "shopify BFCM", "shopify flash sale", "shopify capacity", "shopify k6 test". '---# Shopify Load & Scale## OverviewLoad test Shopify app integrations while respecting API rate limits. Plan capacity for high-traffic events like Black Friday / Cyber Monday (BFCM).## Prerequisites- k6 load testing tool installed (`brew install k6`)- Test store with API access (never load test production)- Understanding of Shopify rate limits per plan## Instructions### Step 1: Understand Capacity ConstraintsYour app's throughput is bounded by Shopify's rate limits, not your infrastructure:| Plan | GraphQL Points | Restore Rate | Max Sustained QPS | Burst Capacity ||------|---------------|-------------|-------------------|----------------|| Standard | 1,000 | 50/sec | ~10 queries/sec | 1,000 points burst || Shopify Plus | 2,000 | 100/sec | ~20 queries/sec | 2,000 points burst |A typical product query costs 10-50 points. At 50 points/query, Standard supports ~1 query/second sustained.### Step 2: k6 Load Test Scriptk6 script with Shopify-specific custom metrics (throttle tracking, query cost trends, error rates) and automatic request pacing.See [k6 Load Test Script](references/k6-load-test-script.md) for the complete test script.### Step 3: Run Load Test```bash# Against a test store — NEVER productionk6 run \ --env SHOPIFY_STORE=dev-store.myshopify.com \ --env SHOPIFY_ACCESS_TOKEN=shpat_test_token \ shopify-load-test.js# Output results to InfluxDB for Grafana dashboardsk6 run --out influxdb=http://localhost:8086/k6 shopify-load-test.js```### Step 4: BFCM / Flash Sale PreparationPre-BFCM preparation including cache pre-warming, Storefront API offloading, bulk inventory sync, and Kubernetes HPA configuration for webhook processing.See [BFCM Preparation](references/bfcm-preparation.md) for application-level and infrastructure scaling patterns.## Output- Load test script calibrated to Shopify rate limits- Performance baseline documented- BFCM preparation checklist completed- Infrastructure scaling configured for webhook volume## Error Handling| Issue | Cause | Solution ||-------|-------|----------|| k6 shows high error rate | Hitting rate limits | Reduce VUs, increase sleep between requests || All requests THROTTLED | Exceeding 50 points/sec | Space queries further apart || Webhooks backing up | Slow processing | Respond 200 immediately, queue processing || Cache stampede on sale start | All caches expire at once | Stagger cache TTLs, pre-warm |## Examples### Quick Capacity Estimate```bash# How many queries can you sustain?# Standard plan: 50 points/sec restore# Your query costs: check with debug headercurl -sf "https://$STORE/admin/api/${SHOPIFY_API_VERSION:-2025-04}/graphql.json" \ -H "X-Shopify-Access-Token: $TOKEN" \ -H "Content-Type: application/json" \ -H "Shopify-GraphQL-Cost-Debug: 1" \ -d '{"query": "{ products(first: 10) { edges { node { id title } } } }"}' \ | jq '"Query cost: \(.extensions.cost.actualQueryCost) points. Max sustained: \(50 / .extensions.cost.actualQueryCost) queries/sec"'```## Resources- [Shopify Rate Limits](https://shopify.dev/docs/api/usage/rate-limits)- [Shopify Plus Rate Limits](https://shopify.dev/changelog/increased-admin-api-rate-limits-for-shopify-plus)- [k6 Documentation](https://k6.io/docs/)- [BFCM Preparation Guide](https://www.shopify.com/blog/bfcm-checklist)---**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `skills/.curated/shopify-load-scale/SKILL.md`**Also appears in:** `jeremylongshore/claude-code-plugins-plus-skills/plugins/saas-packs/shopify-pack/skills/shopify-load-scale/SKILL.md`

Frequently asked questions