New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Shopify Common Errors

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors.

MITAuto-check passedBackend & APIs

Install Shopify Common Errors

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-common-errors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace shopify-common-errors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/shopify-common-errors .claude/skills/shopify-common-errors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
shopify-common-errors
GitHub stars
2.8k
Token cost
~1k tokens
SKILL.md length
381 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors.

  • Works in 2 steps: Identify the Error Type → Match Error Below and Apply Fix
  • Encountering Shopify errors
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Shopify Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors. Use when encountering Shopify errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "shopify error", "fix shopify", "shopify not working", "debug shopify", "shopify 422".

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/diagnostic-script.md`). Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering GraphQL and Debugging. It works with Shopify and GraphQL. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Encountering Shopify errors
  • Debugging failed requests
  • Troubleshooting integration issues
  • With phrases like shopify error

Example prompts

  • “shopify error”
  • “fix shopify”
  • “shopify not working”
  • “/shopify-common-errors”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Grep, Bash(curl:*)

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Identify the Error Type
  2. Match Error Below and Apply Fix

What it can do on your machine

Read from SKILL.md and the folder at commit 23ea8d4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Bash(curl:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • shopify.dev
    • shopifystatus.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Shopify Common Errors loads about 1k tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 381 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 23ea8d4, republished under its MIT licence (© jeremylongshore). 381 words, ~1,013 tokens.

Download SKILL.mdSave it as .claude/skills/shopify-common-errors/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
shopify-common-errors
description
Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors. Use when encountering Shopify errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "shopify error", "fix shopify", "shopify not working", "debug shopify", "shopify 422".
allowed-tools
Read, Grep, Bash(curl:*)
compatibility
Designed for Claude Code
version
2.7.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, ecommerce, shopify

Shopify Common Errors

Overview

Quick-reference guide for the most common Shopify API errors with real error messages, causes, and fixes.

Prerequisites

  • Shopify app with API credentials configured
  • Access to application logs or console output

Instructions

Step 1: Identify the Error Type

Check whether the error is an HTTP status code error or a GraphQL userErrors response.

Step 2: Match Error Below and Apply Fix
401 Unauthorized

Response: "[API] Invalid API key or access token (unrecognized login or wrong password)"

Causes: Access token expired (merchant uninstalled/reinstalled), wrong header, or using Storefront token for Admin API.

Fix: Verify token format (shpat_ + 32 hex chars) and test with a simple shop.json GET request.

403 Forbidden

Response: "This action requires merchant approval for read_orders scope."

Fix: Add the needed scope to shopify.app.toml under [access_scopes] and re-trigger OAuth.

404 Not Found

Causes: Wrong API version in URL, resource was deleted, or store domain is incorrect.

Fix: Verify the API version exists by checking /admin/api/versions.json.

422 Unprocessable Entity

Common triggers: Missing required fields, duplicate handle/slug, invalid metafield type, price format issues (must be string like "29.99"), invalid country/province codes.

Fix: Check the errors object or userErrors array for specific field-level messages.

429 Too Many Requests (Rate Limited)

REST returns 429 with Retry-After header. GraphQL returns 200 with THROTTLED error code in the body and zero currentlyAvailable points.

Fix: See shopify-rate-limits skill for complete backoff implementation.

Show full SKILL.md (152 more words)Show less
GraphQL userErrors (200 with Errors)

Critical: Shopify returns HTTP 200 even when mutations fail. Always check userErrors after every mutation:

typescript
const result = response.data.productCreate;
if (result.userErrors.length > 0) {
  for (const err of result.userErrors) {
    console.error(`Field ${err.field?.join(".")}: ${err.message} (${err.code})`);
  }
  throw new Error("Shopify validation failed");
}
5xx Server Errors

Shopify internal errors -- not your fault. Retry with exponential backoff and capture the X-Request-Id header for support tickets.

Output

  • Error identified by HTTP status or GraphQL userErrors
  • Root cause determined
  • Fix applied and verified

Error Handling

StatusNameRetryableAction
401UnauthorizedNoRe-authenticate, verify token
403ForbiddenNoAdd missing scope, re-OAuth
404Not FoundNoCheck URL, API version, resource ID
422UnprocessableNoFix validation errors in request body
429ThrottledYesBackoff using Retry-After header
500Server ErrorYesRetry with backoff, report X-Request-Id
503UnavailableYesShopify is overloaded, retry later

Examples

Quick Diagnostic Script

Run auth, scope, and API version checks in one pass.

See Diagnostic Script for the complete shell script.

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/shopify-common-errors of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/diagnostic-script.md

Open the folder on GitHubat commit 23ea8d4

Compare with similar skills

Shopify Common Errors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Shopify Common Errors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify Common Errors this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1kAutomated safety check: PassMIT
ShopifyShopify/Shopify-AI-Toolkit589—~4.2kAutomated safety check: PassMIT
Shopify Developmentdavila7/claude-code-templates32k7 repos~2.2kAutomated safety check: PassMIT
Cdrf Expertvintasoftware/django-ai-plugins151—~859Automated safety check: PassNone
Shopify ExpertJeffallan/claude-skills12k—~1.8kAutomated safety check: PassMIT
API TesterRightNow-AI/openfang18k—~807Automated safety check: PassApache-2.0

Similar skills

  • Shopify

    Shopify/Shopify-AI-Toolkit

    Official

    Build anything on Shopify. An agent skill from Shopify/Shopify-AI-Toolkit.

    589 GitHub stars~4.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Shopify Development

    davila7/claude-code-templates

    Build Shopify apps, extensions, themes using GraphQL Admin API, Shopify CLI, Polaris UI, and Liquid.

    32k GitHub starsUsed in 7 repos~2.2k tokens
    Backend & APIsAuto-check passed

  • Cdrf Expert

    vintasoftware/django-ai-plugins

    Expert guidance for Django REST Framework class-based views using Classy DRF (https://www.cdrf.co).

    151 GitHub stars~859 tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

  • Shopify Expert

    Jeffallan/claude-skills

    Builds Shopify themes in Liquid, custom apps, Storefront API storefronts and checkout extensions, using the Shopify CLI to lint, run locally and deploy.

    12k GitHub stars~1.8k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed

  • API Tester

    RightNow-AI/openfang

    API testing expert for curl, REST, GraphQL, authentication, and debugging

    18k GitHub stars~807 tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed

  • Blog Taxonomy

    AgriciDaniel/claude-blog

    Extract, suggest, and sync tags and categories for blog posts across all major CMS platforms.

    2.3k GitHub starsUsed in 1 repo~2.5k tokens
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo

  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes

  • Analyzing Text With NLP

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to perform natural language processing and text analysis using the nlp-text-analyzer plugin.

    2.8k GitHub starsUsed in 1 repo~819 tokens
    Auto-check passed

  • Building Neural Networks

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill allows AI assistant to construct and configure neural network architectures using the neural-network-builder plugin.

    2.8k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

  • Detecting Data Anomalies

    jeremylongshore/tons-of-skills-marketplace

    Process identify anomalies and outliers in datasets using machine learning algorithms.

    2.8k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

  • Explaining Machine Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill enables AI assistant to provide interpretability and explainability for machine learning models.

    2.8k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

  • Optimizing Prompts

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill optimizes prompts for large language models (llms) to reduce token usage, lower costs, and improve performance.

    2.8k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

Works with

Categories

Questions about Shopify Common Errors

What does Shopify Common Errors do?

Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors. Shopify Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors.

When should I use Shopify Common Errors?

Shopify Common Errors fits situations like: encountering Shopify errors; debugging failed requests; troubleshooting integration issues; with phrases like shopify error.

How do I install Shopify Common Errors in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-common-errors -a claude-code`. Or copy the skill folder (skills/.curated/shopify-common-errors in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/shopify-common-errors in your project. Claude Code loads it when a task matches its description.

How do I install Shopify Common Errors in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-common-errors -a codex`. Or copy the skill folder (skills/.curated/shopify-common-errors in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/shopify-common-errors in your project. Codex loads it when a task matches its description.

Can I use Shopify Common Errors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-common-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shopify-common-errors, .gemini/skills/shopify-common-errors, .github/skills/shopify-common-errors and .opencode/skills/shopify-common-errors in your project.

What does Shopify Common Errors need to run?

SKILL.md names no scripts, command-line tools or credentials: Shopify Common Errors is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Bash(curl:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Shopify Common Errors access the network?

SKILL.md names 2 domains. As links in the text: shopify.dev and shopifystatus.com. This is read from the text; nothing was executed.

Is Shopify Common Errors safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Shopify Common Errors use?

Shopify Common Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shopify Common Errors use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 256 tokens, read only when the agent opens those files.

What are the alternatives to Shopify Common Errors?

Skills that share tags, products or a category with Shopify Common Errors: Shopify (Shopify/Shopify-AI-Toolkit, 589 stars), Shopify Development (davila7/claude-code-templates, 32k stars), Cdrf Expert (vintasoftware/django-ai-plugins, 151 stars) and Shopify Expert (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shopify Common Errors?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,821 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 8, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.