shopify-known-pitfalls

Identify and avoid Shopify API anti-patterns: ignoring userErrors, wrong API version, REST instead of GraphQL, missing GDPR webhooks, and webhook timeout issues. Use when reviewing a Shopify codebase, preparing for App Store submission, or debugging mysterious API failures. Trigger with phrases like "shopify mistakes", "shopify anti-patterns", "shopify pitfalls", "shopify what not to do", "shopify code review".

Jump to install

Repository: jeremylongshore/claude-code-plugins-plus-skills
Last source activity: July 17, 2026 at 22:18
Detected SKILL.md language: English
Stars: 2,604
Forks: 378

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill shopify-known-pitfalls

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

clerk-core-workflow-a

Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

2026-07-23

clerk-core-workflow-b

Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".

2026-07-23

clerk-enterprise-rbac

Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".

2026-07-23

View all from this repository

name	shopify-known-pitfalls
description	Identify and avoid Shopify API anti-patterns: ignoring userErrors, wrong API version, REST instead of GraphQL, missing GDPR webhooks, and webhook timeout issues. Use when reviewing a Shopify codebase, preparing for App Store submission, or debugging mysterious API failures. Trigger with phrases like "shopify mistakes", "shopify anti-patterns", "shopify pitfalls", "shopify what not to do", "shopify code review".
allowed-tools	Read, Grep
version	2.7.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","ecommerce","shopify"]
compatibility	Designed for Claude Code

name	shopify-known-pitfalls
description	Identify and avoid Shopify API anti-patterns: ignoring userErrors, wrong API version, REST instead of GraphQL, missing GDPR webhooks, and webhook timeout issues. Use when reviewing a Shopify codebase, preparing for App Store submission, or debugging mysterious API failures. Trigger with phrases like "shopify mistakes", "shopify anti-patterns", "shopify pitfalls", "shopify what not to do", "shopify code review".
allowed-tools	Read, Grep
version	2.7.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","ecommerce","shopify"]
compatibility	Designed for Claude Code

Pitfall	How to Detect	Prevention
Missing userErrors check	Null pointer crashes	ESLint rule or wrapper function
REST usage	`grep -r "clients.Rest" src/`	Migration guide + lint rule
Old API version	`grep -r "apiVersion" src/`	CI check against supported versions
Missing GDPR webhooks	App Store rejection	Pre-submit compliance checker
Webhook timeout	Shopify retry storms	Queue-based processing
ProductInput on 2024-10	GraphQL type error	Update mutations
Page-based pagination	Query errors	Use cursor pagination pattern
`first: 250`	THROTTLED responses	Query cost budgets
Admin token in client	Security audit	Server-side proxy
No APP_UNINSTALLED	Auth loops on reinstall	Webhook handler + session cleanup

Pitfall	Detection	Fix
No userErrors check	Null crashes on mutations	Always check `userErrors.length > 0`
REST instead of GraphQL	`grep "clients.Rest"`	Migrate to `clients.Graphql`
Old API version	`grep "2023-"`	Use `LATEST_API_VERSION` from SDK
Missing GDPR webhooks	App Store rejection	Add 3 mandatory webhook handlers
Webhook timeout	Retry storms, duplicates	Respond 200 immediately, queue processing
ProductInput on 2024-10	Type error	Use `ProductCreateInput` / `ProductUpdateInput`
Page-number pagination	Query errors	Use cursor-based with `pageInfo`
`first: 250` with nesting	THROTTLED	Use `first: 50` or smaller
Admin token in browser	Security scan	Server-side proxy only
No APP_UNINSTALLED	Auth loop on reinstall	Clean up sessions on uninstall

shopify-known-pitfalls

Install options

Review the source files