Agent skill

Shopify

by einverne in einverne/dotfiles

Guide for implementing Shopify apps, extensions, themes, and integrations using GraphQL/REST APIs, Shopify CLI, Polaris UI, and various extension types (Checkout, Admin, POS).

GPL-3.0Auto-check passedBackend & APIs

Install Shopify

skills CLI
$ npx skills add einverne/dotfiles --skill shopify -a claude-code

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

GitHub CLI
$ gh skill install einverne/dotfiles shopify --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/einverne/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/skills/shopify .claude/skills/shopify && 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
GitHub stars
121
Token cost
~2.8k tokens
SKILL.md length
939 words
Files
6
Skills in repo
39
Repo updated
First seen
Licence
GPL-3.0

At a glance

Guide for implementing Shopify apps, extensions, themes, and integrations using GraphQL/REST APIs, Shopify CLI, Polaris UI, and various extension types (Checkout, Admin, POS).

  • Works in 4 steps: Shopify CLI → GraphQL Admin API (Recommended) → REST Admin API (Maintenance Mode) → …
  • Building Shopify apps
  • SKILL.md covers When to Use This Skill, Core Platform Components, Extension Types and Shopify Functions, plus 7 more sections
  • Calls shopify and npm; reaches cdn.shopify.com

What it does

Shopify is an agent skill from einverne/dotfiles. Guide for implementing Shopify apps, extensions, themes, and integrations using GraphQL/REST APIs, Shopify CLI, Polaris UI, and various extension types (Checkout, Admin, POS). Use when building Shopify apps, implementing checkout extensions, customizing admin interfaces, creating themes with Liquid, or integrating with Shopify's APIs.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files (for example `README.md`, `reference/cli-commands.md` and `reference/graphql-admin-api.md`).

It sits in Backend & APIs, covering GraphQL and REST APIs. It works with Shopify and GraphQL. The repository describes itself as: my personal dotfiles managed by dotbot, zinit. The licence is GPL-3.0.

When your agent uses it

  • Building Shopify apps
  • Implementing checkout extensions
  • Customizing admin interfaces
  • Creating themes with Liquid

Example prompts

  • “/shopify”

Requirements

  • Node.js

Workflow steps

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

  1. Shopify CLI
  2. GraphQL Admin API (Recommended)
  3. REST Admin API (Maintenance Mode)
  4. UI Frameworks

What it can do on your machine

Read from SKILL.md and the folder at commit c6c0686. 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

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • cdn.shopify.com

    Also links to:

    • shopify.dev
    • polaris.shopify.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.

Context cost

Shopify loads about 2.8k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 939 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

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 einverne/dotfiles at commit c6c0686, republished under its GPL-3.0 licence (© einverne). 939 words, ~2,787 tokens.

Download SKILL.mdSave it as .claude/skills/shopify/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
shopify
description
Guide for implementing Shopify apps, extensions, themes, and integrations using GraphQL/REST APIs, Shopify CLI, Polaris UI, and various extension types (Checkout, Admin, POS). Use when building Shopify apps, implementing checkout extensions, customizing admin interfaces, creating themes with Liquid, or integrating with Shopify's APIs.

Shopify Development

This skill provides comprehensive guidance for building on the Shopify platform, including apps, extensions, themes, and API integrations.

When to Use This Skill

Use this skill when you need to:

  • Build Shopify apps (public or custom)
  • Create checkout, admin, or POS UI extensions
  • Develop themes using Liquid templating
  • Integrate with Shopify APIs (GraphQL Admin API, REST API, Storefront API)
  • Implement Shopify Functions (discounts, payments, delivery, validation)
  • Build headless storefronts with Hydrogen
  • Configure webhooks and metafields
  • Use Shopify CLI for development workflows

Core Platform Components

1. Shopify CLI

Installation:

bash
npm install -g @shopify/cli@latest

Essential Commands:

  • shopify app init - Create new app
  • shopify app dev - Start local development server
  • shopify app deploy - Deploy app to Shopify
  • shopify app generate extension - Add extension to app
  • shopify theme dev - Preview theme locally
  • shopify theme pull/push - Sync theme files

For detailed CLI reference, see reference/cli-commands.md

Primary API for new development. Efficient, type-safe, flexible.

Endpoint:

https://{shop-name}.myshopify.com/admin/api/2025-01/graphql.json

Authentication:

javascript
headers: {
  'X-Shopify-Access-Token': 'your-access-token',
  'Content-Type': 'application/json'
}

Common Operations:

  • Query products, orders, customers, inventory
  • Create/update/delete resources via mutations
  • Bulk operations for large datasets
  • Real-time data with subscriptions

For comprehensive GraphQL reference, see reference/graphql-admin-api.md

3. REST Admin API (Maintenance Mode)

Use only for legacy systems. Shopify recommends GraphQL for all new development.

Base URL:

https://{shop-name}.myshopify.com/admin/api/2025-01/{resource}.json

Rate Limits:

  • Standard: 2 requests/second
  • Plus: 4 requests/second
4. UI Frameworks
Polaris (React)

Design system for consistent Shopify UI:

bash
npm install @shopify/polaris
Polaris Web Components

Framework-agnostic components:

html
<script src="https://cdn.shopify.com/shopifycloud/polaris.js"></script>

Extension Types

Checkout UI Extensions

Customize checkout experience with native-rendered components.

Generate:

bash
shopify app generate extension --type checkout_ui_extension

Configuration: shopify.extension.toml

Common Components: View, BlockStack, InlineLayout, Button, TextField, Checkbox, Banner

For detailed extension reference, see reference/ui-extensions.md

Admin UI Extensions

Extend Shopify admin interface.

Types:

  • App blocks (embedded in native pages)
  • App overlays (modal experiences)
  • Links (product/collection/order pages)
POS Extensions

Customize Point of Sale experience.

Types:

  • Smart Grid Tiles (quick access actions)
  • Modals (dialogs and forms)
  • Cart modifications (custom discounts/line items)
Post-Purchase Extensions

Upsell offers after checkout completion.

Target: purchase.thank-you.block.render

Customer Account UI Extensions

Customize post-purchase account pages.

Targets: Account overview, order status/index

Shopify Functions

Serverless backend customization running on Shopify infrastructure.

Function Types:

  • Discounts: Cart, product, shipping, order discounts
  • Payment customization: Hide/rename/reorder payment methods
  • Delivery customization: Custom shipping options
  • Order routing: Fulfillment location rules
  • Validation: Cart and checkout business rules
  • Fulfillment constraints: Bundle shipping rules

Languages: JavaScript, Rust, AssemblyScript

Generate:

bash
shopify app generate extension --type function

Theme Development

Liquid Templating

Core Concepts:

  • Objects: {{ product.title }} - Output dynamic content
  • Filters: {{ product.price | money }} - Transform data
  • Tags: {% if %} {% for %} {% case %} - Control flow

Common Objects:

  • product - Product data
  • collection - Collection data
  • cart - Shopping cart
  • customer - Customer account
  • shop - Store information

Architecture:

  • Layouts: Base templates
  • Templates: Page structures
  • Sections: Reusable content blocks (Online Store 2.0)
  • Snippets: Smaller components

Development:

bash
shopify theme dev    # Local preview
shopify theme pull   # Download from store
shopify theme push   # Upload to store

Authentication & Security

OAuth 2.0 Flow

For public apps accessing merchant stores:

  1. Redirect merchant to authorization URL
  2. Merchant approves access
  3. Receive authorization code
  4. Exchange code for access token
  5. Store token securely
Access Scopes

Request minimum permissions needed:

  • read_products - View products
  • write_products - Modify products
  • read_orders - View orders
  • write_orders - Modify orders

Full scope list: https://shopify.dev/api/usage/access-scopes

Session Tokens

For embedded apps in Shopify admin using App Bridge.

Webhooks

Real-time event notifications from Shopify.

Configuration: shopify.app.toml

Common Topics:

  • orders/create, orders/updated, orders/paid
  • products/create, products/update, products/delete
  • customers/create, customers/update
  • app/uninstalled

GDPR Mandatory Webhooks:

  • customers/data_request
  • customers/redact
  • shop/redact

Metafields

Custom data storage for extending Shopify resources.

Owners: Products, variants, customers, orders, collections, shop

Types: text, number, date, URL, JSON, file_reference

Access: Admin API, Storefront API, Liquid templates

Best Practices

Performance
  • Use GraphQL instead of REST for efficiency
  • Request only needed fields in queries
  • Implement pagination for large datasets
  • Use bulk operations for batch processing
  • Respect rate limits (cost-based for GraphQL)
Show full SKILL.md (382 more words)Show less
User Experience
  • Follow Polaris design guidelines
  • Implement loading states
  • Provide clear error messages
  • Support keyboard navigation
  • Test across devices
Security
  • Store API credentials securely
  • Use environment variables for tokens
  • Implement webhook verification
  • Follow OAuth best practices
  • Request minimal access scopes
Code Quality
  • Use TypeScript for type safety
  • Write comprehensive error handling
  • Implement retry logic with exponential backoff
  • Log errors for debugging
  • Keep dependencies updated
Testing
  • Use development stores for testing
  • Test across different store plans
  • Verify webhook handling
  • Test app uninstall flow
  • Validate GDPR compliance

Development Workflow

  1. Initialize App:

    bash
    shopify app init
  2. Configure Access Scopes: Edit shopify.app.toml:

    toml
    [access_scopes]
    scopes = "read_products,write_products"
  3. Start Development Server:

    bash
    shopify app dev
  4. Generate Extensions:

    bash
    shopify app generate extension
  5. Test in Development Store: Install app on test store

  6. Deploy to Production:

    bash
    shopify app deploy

Common Patterns

Fetch Products (GraphQL)
graphql
query {
  products(first: 10) {
    edges {
      node {
        id
        title
        handle
        variants(first: 5) {
          edges {
            node {
              id
              price
              inventoryQuantity
            }
          }
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
Create Product (GraphQL)
graphql
mutation {
  productCreate(input: {
    title: "New Product"
    productType: "Clothing"
    variants: [{
      price: "29.99"
      sku: "SKU123"
    }]
  }) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}
Checkout Extension (React)
javascript
import { useState } from 'react';
import {
  render,
  BlockStack,
  TextField,
  Checkbox,
  useApi
} from '@shopify/ui-extensions-react/checkout';

function Extension() {
  const { extensionPoint } = useApi();
  const [checked, setChecked] = useState(false);

  return (
    <BlockStack>
      <TextField label="Gift Message" />
      <Checkbox checked={checked} onChange={setChecked}>
        This is a gift
      </Checkbox>
    </BlockStack>
  );
}

render('Checkout::Dynamic::Render', () => <Extension />);

Resources

Documentation
Tools
  • GraphiQL Explorer: Built into Shopify admin
  • Shopify CLI: Development workflow
  • Partner Dashboard: App management
  • Development stores: Free testing environments
Learning
  • Shopify Developer Changelog: API updates and deprecations
  • Built for Shopify: Quality program for apps
  • Community forums: Help and discussions

Reference Documentation

This skill includes detailed reference documentation:

Troubleshooting

Common Issues

Rate Limit Errors:

  • Monitor X-Shopify-Shop-Api-Call-Limit header
  • Implement exponential backoff
  • Use bulk operations for large datasets

Authentication Failures:

  • Verify access token is valid
  • Check required scopes are granted
  • Ensure OAuth flow completed correctly

Webhook Not Receiving Events:

  • Verify webhook URL is accessible
  • Check webhook signature validation
  • Review webhook logs in Partner Dashboard

Extension Not Appearing:

  • Verify extension target is correct
  • Check extension is published
  • Ensure app is installed on store

Version Management

Shopify uses quarterly API versioning (YYYY-MM format):

  • Current: 2025-01
  • Each version supported for 12 months
  • Test updates before quarterly releases
  • Use version-specific endpoints

App Distribution

Custom Apps

Single merchant installation, no review required.

Public Apps

App Store listing with Shopify review:

  • Follow app requirements
  • Complete Built for Shopify criteria
  • Define pricing model
  • Submit for review

Note: This skill covers the Shopify platform as of January 2025. Always refer to official Shopify documentation for the latest updates and API versions.

© einverne, GPL-3.0. 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 5 other files in claude/skills/shopify of einverne/dotfiles.

  • SKILL.md
  • README.md
  • reference/cli-commands.md
  • reference/graphql-admin-api.md
  • reference/ui-extensions.md
  • shopify-graphql-admin-api-analysis.md

Open the folder on GitHubat commit c6c0686

Compare with similar skills

Shopify 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shopify this skilleinverne/dotfiles121—~2.8kAutomated safety check: PassGPL-3.0
Blog TaxonomyAgriciDaniel/claude-blog2.3k1 repos~2.5kAutomated safety check: PassMIT
Shopify Upgrade Migrationjeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: PassMIT
ShopifyMicrock/ordinary-claude-skills403—~1.9kAutomated safety check: PassCustom licence
API DesignerJeffallan/claude-skills12k2 repos~2kAutomated safety check: PassMIT
Nodejs Backend Patternsever-works/ever-works15818 repos~4kAutomated safety check: PassAGPL-3.0

Similar skills

  • 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
  • Shopify Upgrade Migration

    jeremylongshore/tons-of-skills-marketplace

    Upgrade Shopify API versions and migrate from REST to GraphQL with breaking change detection.

    2.8k GitHub stars~1.3k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Shopify

    Microck/ordinary-claude-skills

    Build Shopify applications, extensions, and themes using GraphQL/REST APIs, Shopify CLI, Polaris UI components, and Liquid templating.

    403 GitHub stars~1.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    158 GitHub starsUsed in 18 repos~4k tokens
    Backend & APIsAuto-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 yesterday
    Backend & APIsAuto-check passed

More from einverne/dotfiles

All 39 skills in this repo
  • Chrome Devtools

    einverne/dotfiles

    Browser automation, debugging, and performance analysis using Puppeteer CLI scripts.

    121 GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check: notes
  • DOCX

    einverne/dotfiles

    Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction.

    121 GitHub starsUsed in 35 repos~2.5k tokens
    Auto-check: notes
  • PDF

    einverne/dotfiles

    Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms.

    121 GitHub starsUsed in 47 repos~1.8k tokens
    Auto-check passed
  • Gemini Audio

    einverne/dotfiles

    Guide for implementing Google Gemini API audio capabilities - analyze audio with transcription, summarization, and understanding (up to 9.5 hours), plus generate speech with controllable TTS.

    121 GitHub starsUsed in 1 repo~2k tokens
    Auto-check: notes
  • Gemini Image Gen

    einverne/dotfiles

    Guide for implementing Google Gemini API image generation - create high-quality images from text prompts using gemini-2.5-flash-image model.

    121 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check: notes
  • Gemini Vision

    einverne/dotfiles

    Guide for implementing Google Gemini API image understanding - analyze images with captioning, classification, visual QA, object detection, segmentation, and multi-image comparison.

    121 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check: notes

Works with

Categories

Questions about Shopify

What does Shopify do?

Guide for implementing Shopify apps, extensions, themes, and integrations using GraphQL/REST APIs, Shopify CLI, Polaris UI, and various extension types (Checkout, Admin, POS). Shopify is an agent skill from einverne/dotfiles. Guide for implementing Shopify apps, extensions, themes, and integrations using GraphQL/REST APIs, Shopify CLI, Polaris UI, and various extension types (Checkout, Admin, POS).

When should I use Shopify?

Shopify fits situations like: building Shopify apps; implementing checkout extensions; customizing admin interfaces; creating themes with Liquid.

How do I install Shopify in Claude Code?

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

How do I install Shopify in Codex?

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

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

What does Shopify need to run?

Going by SKILL.md and its folder, Shopify needs the command-line tools its instructions call (shopify and npm). Our summary lists: Node.js.

Does Shopify access the network?

SKILL.md names 3 domains. In commands or code: cdn.shopify.com; the agent is likely to contact it when it follows the instructions. As links in the text: shopify.dev and polaris.shopify.com. This is read from the text; nothing was executed.

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

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

How many tokens does Shopify use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shopify?

Skills that share tags, products or a category with Shopify: Blog Taxonomy (AgriciDaniel/claude-blog, 2.3k stars), Shopify Upgrade Migration (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Shopify (Microck/ordinary-claude-skills, 403 stars) and API Designer (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?

einverne (a GitHub user) maintains it in einverne/dotfiles, which has 121 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on September 9, 2026.

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