Agent skill

Shopify Debug Bundle

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

Collect Shopify debug evidence including API versions, scopes, rate limit state, and request logs.

MITAuto-check passedSales & Support

Install Shopify Debug Bundle

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

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace shopify-debug-bundle --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-debug-bundle .claude/skills/shopify-debug-bundle && 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-debug-bundle
GitHub stars
2.8k
Token cost
~784 tokens
SKILL.md length
236 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Collect Shopify debug evidence including API versions, scopes, rate limit state, and request logs.

  • Encountering persistent issues
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Calls curl and jq; needs SHOPIFY_ACCESS_TOKEN
  • Preparing support tickets

What it does

Shopify Debug Bundle is an agent skill from jeremylongshore/tons-of-skills-marketplace. Collect Shopify debug evidence including API versions, scopes, rate limit state, and request logs. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for Shopify problems. Trigger with phrases like "shopify debug", "shopify support bundle", "collect shopify logs", "shopify diagnostic".

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

It sits in Sales & Support, covering Rate limiting and Customer support. It works with Shopify. 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 persistent issues
  • Preparing support tickets
  • Collecting diagnostic information for Shopify problems
  • With phrases like shopify debug

Example prompts

  • “shopify debug”
  • “shopify support bundle”
  • “collect shopify logs”
  • “/shopify-debug-bundle”

Requirements

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

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
    • Bash(curl:*)
    • Bash(tar:*)
    • Bash(node:*)
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq

    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
    • help.shopify.com
    • shopifystatus.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SHOPIFY_ACCESS_TOKEN

    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 Debug Bundle loads about 784 tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 236 words of instructions outside code blocks.

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

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). 236 words, ~784 tokens.

Download SKILL.mdSave it as .claude/skills/shopify-debug-bundle/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
shopify-debug-bundle
description
Collect Shopify debug evidence including API versions, scopes, rate limit state, and request logs. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for Shopify problems. Trigger with phrases like "shopify debug", "shopify support bundle", "collect shopify logs", "shopify diagnostic".
allowed-tools
Read, Bash(curl:*), Bash(tar:*), Bash(node:*), Grep
compatibility
Designed for Claude Code
version
2.7.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, ecommerce, shopify

Shopify Debug Bundle

Overview

Collect all diagnostic information needed for Shopify support tickets: API version compatibility, access scopes, rate limit state, recent errors, and connectivity checks.

Prerequisites

  • Shopify access token (shpat_xxx) available
  • curl and jq installed
  • Store domain known (*.myshopify.com)

Instructions

Step 1: Create and Run Debug Bundle

The debug bundle script collects shop info, access scopes, supported API versions, GraphQL and REST rate limit state, environment details (Node/npm versions, SDK version, env vars), then packages everything into a tarball with tokens automatically redacted.

See Debug Bundle Script for the complete bash script.

Set these environment variables before running:

bash
export SHOPIFY_STORE="your-store.myshopify.com"
export SHOPIFY_ACCESS_TOKEN="shpat_xxx"
export SHOPIFY_API_VERSION="2025-04"  # Update quarterly — see shopify.dev/docs/api/usage/versioning

Output

  • shopify-debug-YYYYMMDD-HHMMSS.tar.gz containing:
    • summary.txt — shop info, scopes, API versions, rate limits, environment
    • All secrets automatically redacted

Error Handling

DiagnosticWhat It RevealsIf It Fails
Shop infoStore name, plan, timezoneToken invalid or store unreachable
Access scopesWhat your app can accessToken expired or revoked
API versionsWhich versions the store supportsNetwork issue
Rate limit stateCurrent bucket fill levelToken or network issue
SDK versionWhether SDK needs updatingPackage not installed

Examples

Sensitive Data Checklist

ALWAYS REDACT before sharing:

  • Access tokens (shpat_xxx)
  • API keys and secrets
  • Customer PII (emails, names, addresses)
  • Order details with customer data

Safe to include:

  • Store name and plan
  • API version and scopes
  • Error messages and X-Request-Id values
  • Rate limit headers
  • SDK/runtime versions
Quick One-Liner Health Check
bash
curl -sf -H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \
  "https://$SHOPIFY_STORE/admin/api/2025-04/shop.json" \
  | jq '{name: .shop.name, plan: .shop.plan_name}' \
  && echo "HEALTHY" || echo "UNHEALTHY"

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-debug-bundle of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/debug-bundle-script.md

Open the folder on GitHubat commit 23ea8d4

Compare with similar skills

Shopify Debug Bundle 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 Debug Bundle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify Debug Bundle this skilljeremylongshore/tons-of-skills-marketplace2.8k—~784Automated safety check: PassMIT
Shopify Admin Address Correction40RTY-ai/shopify-admin-skills194—~1.5kAutomated safety check: PassMIT
Shopify Review Triagegithub/awesome-copilot40k—~4.2kAutomated safety check: PassMIT
Whatsapp Telegramericrisco/rsc-harness167—~2.9kAutomated safety check: PassMIT
Shopify Admin Bulk Customer Tag Update40RTY-ai/shopify-admin-skills194—~2kAutomated safety check: PassMIT
Shopify Admin Customer Merge40RTY-ai/shopify-admin-skills194—~2.4kAutomated safety check: PassMIT

Similar skills

  • Shopify Admin Address Correction

    40RTY-ai/shopify-admin-skills

    Update the shipping address on an unfulfilled order before it ships.

    194 GitHub stars~1.5k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Shopify Review Triage

    github/awesome-copilot

    Official

    A skill your agent uses when someone wants public Shopify App Store reviews, low-star reviews, or merchant feedback triaged, prioritized, clustered, or turned into a product or support brief.

    40k GitHub stars~4.2k tokensUpdated today
    Sales & SupportAuto-check passed
  • Whatsapp Telegram

    ericrisco/rsc-harness

    A skill your agent uses when wiring an app or agent to message customers over the WhatsApp Cloud API or a Telegram bot — order updates, OTP codes, reminders, alerts and broadcasts — or when…

    167 GitHub stars~2.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Shopify Admin Bulk Customer Tag Update

    40RTY-ai/shopify-admin-skills

    Adds and/or removes tags across a filtered set of customers — supports query-based selection, explicit ID lists, and union/replace tag modes.

    194 GitHub stars~2k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Shopify Admin Customer Merge

    40RTY-ai/shopify-admin-skills

    Merges duplicate customer records: invokes Shopify's native customer merge API where supported, otherwise consolidates the loser record's tags and notes into the winner via customerUpdate.

    194 GitHub stars~2.4k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Shopify Admin Customer Timeline Export

    40RTY-ai/shopify-admin-skills

    Read-only: exports a complete chronological history for a single customer — orders, refunds, returns, addresses, notes, tags, marketing consent, and lifetime spend — as one consolidated CSV.

    194 GitHub stars~2.1k tokensUpdated 1 mo ago
    Sales & SupportAuto-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

Questions about Shopify Debug Bundle

What does Shopify Debug Bundle do?

Collect Shopify debug evidence including API versions, scopes, rate limit state, and request logs. Shopify Debug Bundle is an agent skill from jeremylongshore/tons-of-skills-marketplace. Collect Shopify debug evidence including API versions, scopes, rate limit state, and request logs.

When should I use Shopify Debug Bundle?

Shopify Debug Bundle fits situations like: encountering persistent issues; preparing support tickets; collecting diagnostic information for Shopify problems; with phrases like shopify debug.

How do I install Shopify Debug Bundle in Claude Code?

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

How do I install Shopify Debug Bundle in Codex?

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

Can I use Shopify Debug Bundle 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-debug-bundle -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-debug-bundle, .gemini/skills/shopify-debug-bundle, .github/skills/shopify-debug-bundle and .opencode/skills/shopify-debug-bundle in your project.

What does Shopify Debug Bundle need to run?

Going by SKILL.md and its folder, Shopify Debug Bundle needs the command-line tools its instructions call (curl and jq) and credentials named SHOPIFY_ACCESS_TOKEN. Our summary lists: A credential in SHOPIFY_ACCESS_TOKEN. Its frontmatter pre-approves these tools: Read, Bash(curl:*), Bash(tar:*), Bash(node:*), Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Shopify Debug Bundle access the network?

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

Is Shopify Debug Bundle 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 Debug Bundle use?

Shopify Debug Bundle 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 Debug Bundle use?

About 784 tokens (SKILL.md is roughly 3.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 928 tokens, read only when the agent opens those files.

What are the alternatives to Shopify Debug Bundle?

Skills that share tags, products or a category with Shopify Debug Bundle: Shopify Admin Address Correction (40RTY-ai/shopify-admin-skills, 194 stars), Shopify Review Triage (github/awesome-copilot, 40k stars), Whatsapp Telegram (ericrisco/rsc-harness, 167 stars) and Shopify Admin Bulk Customer Tag Update (40RTY-ai/shopify-admin-skills, 194 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shopify Debug Bundle?

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.