Agent skill · software engineering · jeremylongshore
shopify-install-auth
Install and configure Shopify app authentication with OAuth, session
Why this skill is useful
Provides specific implementation details for Shopify app authentication that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. Requires shopify account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Install & Auth Overview Set up Shopify app authentication using the official @shopify/shopify-api library. Covers OAuth flow, session token exchange, custom app tokens, and Storefront API access. Prerequisites Node.js 18+ (the @shopify/shopify-api v9+ requires it) A Shopify Partner account at https://partners.shopify.com An app created in the Partner Dashboard with API credentials A development store for testing Instructions Step 1: Install the Shopify API Library Step 2: Configure Environment Variables Create a .env file (add to .gitignore immediately): Step 3: Initialize the Shopify API Library Step 4: Implement OAuth Flow (Public Apps) Express-based OAuth flow that redirects to Shopify and handles the callback token exchange. See OAuth Flow for the complete Express route implementation. Step 5: Token Exchange (Embedded Apps) For embedded apps, use session token exchange instead of traditional OAuth: Step 6: Custom App / Private App Auth For custom apps installed on a single store, use a permanent access token with no OAuth needed. See Custom App Auth for the complete setup. Step 7: Verify Auth is Working Output @shopify/shopify-api installed and configured OAuth flow or custom app auth operational Session with valid access token persisted Verified connection to the Shopify Admin API Error Handling Error Cause Solution ------- ------- ---------- InvalidApiKeyError Wrong SHOPIFYAPIKEY Verify in Partner Dashboard > App > API credentials InvalidHmacError during callback Secret mismatch or URL tampering Check SHOPIFYAPISECRET matches Partner Dashboard SessionNotFound Session not persisted Implement SessionStorage (DB, Redis, or file) HttpResponseError: 401 Token expired or revoked Merchant uninstalled app — trigger re-auth InvalidScopeError Requested scope not approved Only use scopes from the approved list in your app config ShopifyErrors.InvalidShop Malformed shop domain Must be .myshopify.com — use sanitizeShop() Examples Shopify API Access Scopes Reference …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-install-auth--2c5cd2