Agent skill

Shopify Setup

by jezweb in jezweb/claude-skills

Set up Shopify CLI auth and Admin API access for a store. An agent skill from jezweb/claude-skills.

MITAuto-check passedSales & Support

Install Shopify Setup

skills CLI
$ npx skills add jezweb/claude-skills --skill shopify-setup -a claude-code

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

GitHub CLI
$ gh skill install jezweb/claude-skills shopify-setup --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/jezweb/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/shopify/skills/shopify-setup .claude/skills/shopify-setup && 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-setup
GitHub stars
1.1k
Token cost
~988 tokens
SKILL.md length
405 words
Files
2 (incl. references)
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Set up Shopify CLI auth and Admin API access for a store. An agent skill from jezweb/claude-skills.

  • Works in 6 steps: Check Prerequisites → Authenticate with the Store → Create a Custom App for API Access → …
  • The user wants to connect to a Shopify store
  • SKILL.md covers Workflow, Critical Patterns and Reference Files
  • Calls shopify, npm and curl; needs SHOPIFY_ACCESS_TOKEN

What it does

Shopify Setup is an agent skill from jezweb/claude-skills. Set up Shopify CLI auth and Admin API access for a store. Install CLI, authenticate, create custom app, store access token, verify. Use whenever the user wants to connect to a Shopify store, set up Shopify API access, install Shopify CLI, or troubleshoot Shopify auth / Admin API token issues.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/api-scopes.md`). Compatibility notes: claude-code-only

It sits in Sales & Support, covering E-commerce operations and App store release. It works with Shopify. The repository describes itself as: Skills for Claude Code CLI such as full stack dev Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.

When your agent uses it

  • The user wants to connect to a Shopify store
  • Set up Shopify API access
  • Install Shopify CLI
  • Troubleshoot Shopify auth / Admin API token issues

Example prompts

  • “/shopify-setup”

Requirements

  • Node.js
  • A credential in SHOPIFY_ACCESS_TOKEN
  • Compatibility (from SKILL.md): claude-code-only

Workflow steps

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

  1. Check Prerequisites
  2. Authenticate with the Store
  3. Create a Custom App for API Access
  4. Store the Access Token
  5. Verify API Access
  6. Save Store Config

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • shopify
    • npm
    • curl
    • jq

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

  • Network

    No URLs in SKILL.md. Its commands use npm and curl, which can reach the network depending on how they are called.

    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

    claude-code-only

    From compatibility in the SKILL.md frontmatter.

Context cost

Shopify Setup loads about 988 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 405 words of instructions outside code blocks.

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

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 jezweb/claude-skills at commit 64965d9, republished under its MIT licence (© jezweb). 405 words, ~988 tokens.

Download SKILL.mdSave it as .claude/skills/shopify-setup/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
shopify-setup
description
Set up Shopify CLI auth and Admin API access for a store. Install CLI, authenticate, create custom app, store access token, verify. Use whenever the user wants to connect to a Shopify store, set up Shopify API access, install Shopify CLI, or troubleshoot Shopify auth / Admin API token issues.
compatibility
claude-code-only

Shopify Setup

Set up working Shopify CLI authentication and Admin API access for a store. Produces a verified API connection ready for product and content management.

Workflow

Step 1: Check Prerequisites

Verify the Shopify CLI is installed:

bash
shopify version

If not installed:

bash
npm install -g @shopify/cli
Step 2: Authenticate with the Store
bash
shopify auth login --store mystore.myshopify.com

This opens a browser for OAuth. The user must be a store owner or staff member with appropriate permissions.

After login, verify:

bash
shopify store info
Step 3: Create a Custom App for API Access

Custom apps provide stable Admin API access tokens (unlike CLI session tokens which expire).

Check if an app already exists: Ask the user if they have a custom app set up. If yes, skip to Step 4.

If no custom app exists, guide the user through creation via browser:

  1. Navigate to https://{store}.myshopify.com/admin/settings/apps/development
  2. Click Create an app
  3. Name it (e.g. "Claude Code Integration")
  4. Click Configure Admin API scopes
  5. Enable these scopes (see references/api-scopes.md for details):
    • read_products, write_products
    • read_content, write_content
    • read_product_listings
    • read_inventory, write_inventory
    • read_files, write_files
  6. Click Save then Install app
  7. Copy the Admin API access token (shown only once)

Use browser automation (Chrome MCP or playwright-cli) if the user prefers assistance navigating the admin.

Step 4: Store the Access Token

Store the token securely. Never commit it to git.

For project use — create .dev.vars:

SHOPIFY_STORE=mystore.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxx

Ensure .dev.vars is in .gitignore.

For cross-project use — store in your preferred secrets manager (environment variable, 1Password CLI, etc.).

Show full SKILL.md (170 more words)Show less
Step 5: Verify API Access

Test the connection with a simple GraphQL query:

bash
curl -s https://{store}.myshopify.com/admin/api/2025-01/graphql.json \
  -H "Content-Type: application/json" \
  -H "X-Shopify-Access-Token: {token}" \
  -d '{"query": "{ shop { name primaryDomain { url } } }"}' | jq .

Expected response includes the shop name and domain. If you get a 401, the token is invalid or expired — recreate the app.

Step 6: Save Store Config

Create a shopify.config.json in the project root for other skills to reference:

json
{
  "store": "mystore.myshopify.com",
  "apiVersion": "2025-01",
  "tokenSource": ".dev.vars"
}

Critical Patterns

API Version

Always specify an explicit API version (e.g. 2025-01). Using unstable in production will break without warning. Shopify retires API versions quarterly.

Token Types
TokenFormatUse
Admin API access tokenshpat_*Custom apps — stable, long-lived
CLI session tokenShort-livedShopify CLI commands only
Storefront API tokenshpca_*Public storefront queries

This skill sets up Admin API access tokens — the right choice for product and content management.

Rate Limits

Shopify uses a leaky bucket rate limiter:

  • REST: 40 requests/second burst, 2/second sustained
  • GraphQL: 1,000 cost points per second, max 2,000 points per query

For bulk operations, use the bulkOperationRunQuery mutation instead of looping.


Reference Files

  • references/api-scopes.md — Admin API scopes needed for product and content management

© jezweb, 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 plugins/shopify/skills/shopify-setup of jezweb/claude-skills.

  • SKILL.md
  • references/api-scopes.md

Open the folder on GitHubat commit 64965d9

Compare with similar skills

Shopify Setup 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 Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify Setup this skilljezweb/claude-skills1.1k—~988Automated safety check: PassMIT
Distribution Channelskostja94/marketing-skills1k—~1kAutomated safety check: PassMIT
Shopify Review Triagegithub/awesome-copilot40k—~4.2kAutomated safety check: PassMIT
Shopify Admin Sales By Channel Report40RTY-ai/shopify-admin-skills194—~1.2kAutomated safety check: PassMIT
ShopifyShopify/Shopify-AI-Toolkit589—~4.2kAutomated safety check: PassMIT
Checkout Purchasekeypo-us/keypo-cli182—~880Automated safety check: NotesNone

Similar skills

  • Distribution Channels

    kostja94/marketing-skills

    When the user wants to plan product distribution via marketplaces, app stores, or third-party platforms.

    1k GitHub stars~1k tokensUpdated 2 days 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
  • Shopify Admin Sales By Channel Report

    40RTY-ai/shopify-admin-skills

    Read-only: breaks down revenue, units, and AOV by sales channel (Online Store, POS, Draft Orders, etc.).

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

    Shopify/Shopify-AI-Toolkit

    Official

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

    589 GitHub stars~4.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Checkout Purchase

    keypo-us/keypo-cli

    A skill your agent uses when the user asks to buy a product from the Shopify store.

    182 GitHub stars~880 tokensUpdated 6 mo ago
    Sales & SupportAuto-check: notes
  • Afa

    afadtc/afa-dtc-skills

    AFA DTC 全链路独立站操盘系统——系统入口、一级路由器、工作流编排器,统筹品牌基建、付费获客、有机增长、变现留存、运营扩张五大业务线。Use when user mentions: 独立站, DTC, 电商, ecommerce, Shopify, 品牌站, 独立站运营, DTC品牌, 全链路, 操盘, 独立站诊断, 独立站增长, 独立站策略.

    168 GitHub stars~2.6k tokensUpdated 9 days ago
    Sales & SupportAuto-check passed

More from jezweb/claude-skills

All 52 skills in this repo
  • Elevenlabs Agents

    jezweb/claude-skills

    Build conversational AI voice agents on the ElevenLabs platform.

    1.1k GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed
  • Favicon Gen

    jezweb/claude-skills

    Generate custom favicons from logos, text, or brand colours.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Tailwind Theme Builder

    jezweb/claude-skills

    Set up Tailwind v4 + shadcn/ui themed UI with dark mode. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Project Health

    jezweb/claude-skills

    All-in-one project configuration and health management. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Responsiveness Check

    jezweb/claude-skills

    Test website responsiveness across viewport widths using browser automation.

    1.1k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • MCP Builder

    jezweb/claude-skills

    Build MCP servers in Python with FastMCP. An agent skill from jezweb/claude-skills.

    1.1k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Questions about Shopify Setup

What does Shopify Setup do?

Set up Shopify CLI auth and Admin API access for a store. An agent skill from jezweb/claude-skills. Shopify Setup is an agent skill from jezweb/claude-skills. Set up Shopify CLI auth and Admin API access for a store.

When should I use Shopify Setup?

Shopify Setup fits situations like: the user wants to connect to a Shopify store; set up Shopify API access; install Shopify CLI; troubleshoot Shopify auth / Admin API token issues.

How do I install Shopify Setup in Claude Code?

Run `npx skills add jezweb/claude-skills --skill shopify-setup -a claude-code`. Or copy the skill folder (plugins/shopify/skills/shopify-setup in jezweb/claude-skills) into .claude/skills/shopify-setup in your project. Claude Code loads it when a task matches its description.

How do I install Shopify Setup in Codex?

Run `npx skills add jezweb/claude-skills --skill shopify-setup -a codex`. Or copy the skill folder (plugins/shopify/skills/shopify-setup in jezweb/claude-skills) into .agents/skills/shopify-setup in your project. Codex loads it when a task matches its description.

Can I use Shopify Setup 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 jezweb/claude-skills --skill shopify-setup -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-setup, .gemini/skills/shopify-setup, .github/skills/shopify-setup and .opencode/skills/shopify-setup in your project.

What does Shopify Setup need to run?

Going by SKILL.md and its folder, Shopify Setup needs the command-line tools its instructions call (shopify, npm, curl and jq) and credentials named SHOPIFY_ACCESS_TOKEN. Our summary lists: Node.js; A credential in SHOPIFY_ACCESS_TOKEN. Compatibility (from SKILL.md): claude-code-only.

Does Shopify Setup access the network?

SKILL.md contains no URLs. Its commands use npm and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

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

Shopify Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shopify Setup use?

About 988 tokens (SKILL.md is roughly 4k 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 485 tokens, read only when the agent opens those files.

What are the alternatives to Shopify Setup?

Skills that share tags, products or a category with Shopify Setup: Distribution Channels (kostja94/marketing-skills, 1k stars), Shopify Review Triage (github/awesome-copilot, 40k stars), Shopify Admin Sales By Channel Report (40RTY-ai/shopify-admin-skills, 194 stars) and Shopify (Shopify/Shopify-AI-Toolkit, 589 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shopify Setup?

jezweb (a GitHub user) maintains it in jezweb/claude-skills, which has 1,051 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 5, 2026.

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