# Shopify Admin Skills — Full Documentation for AI Agents **Source:** https://skills.40rty.ai **Summary file:** https://skills.40rty.ai/llms.txt **Generated:** at build time from the repository, so every count and every skill below reflects what actually ships. --- ## 1. Product Overview **Shopify Admin Skills** is a free, open-source library of 116 structured AI agent skills and 23 automated routines for Shopify store operators, across 11 categories. Built by 40rty. Each skill is a structured prompt that guides an AI agent through a specific Shopify store operation using the Shopify Admin GraphQL API. Skills work with any MCP-compatible AI agent: Claude (claude.ai), Claude Code (CLI), Claude Cowork, Cursor, Cline, GitHub Copilot, and Gemini CLI. **Key differentiator:** unlike generic Shopify automation tools, these are agent-native — designed to run inside the AI assistant the merchant already uses, with no separate dashboard, no SaaS subscription, and no vendor lock-in. --- ## 2. Installation ### Option A — Terminal (any agent) ``` npx skills add 40RTY-ai/shopify-admin-skills ``` Works with Claude Code, Claude Cowork, Cursor, Cline, Copilot, Gemini CLI. ### Option B — Claude / Claude Cowork (guided) Paste the install prompt into Claude or Claude Cowork. Claude acts as a concierge: installs plugins, authenticates with your Shopify store, and walks you through your first skill interactively. ### What gets installed - **116 skills** — on-demand agent workflows for every Shopify operation - **23 routines** — scheduled agents that run automatically on a cron ### Authentication During setup, the agent authenticates with your Shopify Admin API using this default scope set: `read_products, write_products, read_orders, write_orders, read_customers, write_customers, read_inventory, write_inventory, read_discounts, write_discounts, read_fulfillments, write_fulfillments, read_returns, write_returns, read_price_rules, write_price_rules, read_publications, write_publications, read_shopify_payments_payouts` --- ## 3. Skills Reference (116 skills across 11 categories) Every skill that ships, with its own documentation page. ### 3.1 Agentic (10) - **shopify-admin-agentic-crawler-access** — Edit the theme's robots.txt.liquid to explicitly allow AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, Amazonbot) so AI assistants are permitted to read the catalog. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-crawler-access/ - **shopify-admin-agentic-description-enrichment** — Rewrite thin product descriptions into structured, fact-rich copy (materials, fit, use-cases, the words shoppers actually type) so AI agents have something concrete to quote and match. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-description-enrichment/ - **shopify-admin-agentic-image-alt-text** — Generate and set descriptive alt text on product images so AI agents (which can't 'see' pixels) can understand and recommend what each product looks like. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-image-alt-text/ - **shopify-admin-agentic-llms-txt** — Generate and publish an /llms.txt guide (brand summary, flagship products, key policies, contact) via a theme template so AI assistants get a curated, machine-readable map of the store. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-llms-txt/ - **shopify-admin-agentic-metafields-setup** — Define and populate agentic-commerce metafields (material, attributes, key features, specs, sizing) so AI agents can filter and match products to specific shopper requirements. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-metafields-setup/ - **shopify-admin-agentic-organization-schema** — Inject an Organization JSON-LD block (name, logo, sameAs social links, contactPoint) into the theme so AI agents can verify the store is a real, trusted brand and link it to its public identity. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-organization-schema/ - **shopify-admin-agentic-policy-readability** — Ensure shipping, returns, refund, privacy, and terms policies exist as clean machine-readable text so AI agents can answer shopper questions and close the sale without escalating. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-policy-readability/ - **shopify-admin-agentic-product-jsonld-backfill** — Backfill the structured product/variant fields that power Product JSON-LD — barcode (GTIN), SKU, vendor, product type, weight — so AI agents can quote exact, in-stock items instead of guessing. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-product-jsonld-backfill/ - **shopify-admin-agentic-product-taxonomy** — Assign every product a Shopify Standard Product Taxonomy category so AI agents can map a shopper's intent to the right category and surface the store's products. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-product-taxonomy/ - **shopify-admin-agentic-readiness-audit** — Score how findable, readable, and recommendable the store's catalog is to AI shopping agents — then route each gap to the agentic skill that fixes it. https://skills.40rty.ai/skills/agentic/shopify-admin-agentic-readiness-audit/ ### 3.2 Conversion Optimization (10) - **shopify-admin-checkout-abandonment-report** — Aggregate abandoned checkout data for a time range, broken down by cart value bucket and hour of day (UTC). https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-checkout-abandonment-report/ - **shopify-admin-cross-sell-opportunity-finder** — Read-only: identifies products with high single-purchase rates that could benefit from cross-sell pairing based on category and price affinity. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-cross-sell-opportunity-finder/ - **shopify-admin-discount-ab-analysis** — Compare redemption rates and revenue performance across two or more discount codes over a specified date range. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-discount-ab-analysis/ - **shopify-admin-discount-roi-calculator** — Read-only: calculates the true ROI of each discount code and automatic discount by comparing incremental revenue against discount cost. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-discount-roi-calculator/ - **shopify-admin-frequently-bought-together** — Read-only: mines order history to find product pairs and triplets frequently purchased together, generating cross-sell and bundle recommendations. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-frequently-bought-together/ - **shopify-admin-gift-card-issuance** — Issue Shopify gift cards (store credit) to customers as a goodwill gesture, post-return incentive, or loyalty reward. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-gift-card-issuance/ - **shopify-admin-gift-message-extraction** — Read-only: extracts gift messages, gift recipients, and gift flags from order custom attributes and notes for fulfillment teams to print on packing slips. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-gift-message-extraction/ - **shopify-admin-post-purchase-survey-trigger** — Read-only: identifies orders 7–14 days post-fulfillment that are eligible for a post-purchase survey campaign, excluding refunded or cancelled orders. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-post-purchase-survey-trigger/ - **shopify-admin-top-product-performance** — Rank products by revenue, units sold, and refund rate over a date range by aggregating order line items. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-top-product-performance/ - **shopify-admin-traffic-by-page-report** — Report sessions, conversion rate, and bounce rate for every product and collection page using Shopify's analytics API — surfaces which pages earn eyeballs and which convert them. https://skills.40rty.ai/skills/conversion-optimization/shopify-admin-traffic-by-page-report/ ### 3.3 Customer Ops (11) - **shopify-admin-b2b-company-overview** — Read-only: lists B2B company accounts with locations, catalogs, and payment terms for wholesale management. https://skills.40rty.ai/skills/customer-ops/shopify-admin-b2b-company-overview/ - **shopify-admin-chargeback-watchlist-tagger** — Identifies customers with disputed or charged-back orders and tags their customer record for proactive review on future orders. https://skills.40rty.ai/skills/customer-ops/shopify-admin-chargeback-watchlist-tagger/ - **shopify-admin-churn-risk-scorer** — Read-only: scores customers by churn probability based on purchase recency, frequency decay, and expected repurchase intervals. https://skills.40rty.ai/skills/customer-ops/shopify-admin-churn-risk-scorer/ - **shopify-admin-customer-acquisition-cost-by-source** — Read-only: estimates customer acquisition cost (CAC) per traffic source by joining order count per landing site / referrer with configurable ad spend. https://skills.40rty.ai/skills/customer-ops/shopify-admin-customer-acquisition-cost-by-source/ - **shopify-admin-customer-cohort-analysis** — Read-only: groups customers by first-purchase month and tracks repeat purchase rate and revenue per cohort. https://skills.40rty.ai/skills/customer-ops/shopify-admin-customer-cohort-analysis/ - **shopify-admin-customer-note-bulk-annotator** — Adds internal notes to customer records in bulk — useful for post-campaign flags, import annotations, or support context. https://skills.40rty.ai/skills/customer-ops/shopify-admin-customer-note-bulk-annotator/ - **shopify-admin-customer-spend-tier-tagger** — Calculates lifetime spend per customer and applies tier tags (Bronze/Silver/Gold/Platinum) based on configurable thresholds. https://skills.40rty.ai/skills/customer-ops/shopify-admin-customer-spend-tier-tagger/ - **shopify-admin-duplicate-customer-finder** — Read-only: finds likely duplicate customer records by matching email, phone, or name combinations. https://skills.40rty.ai/skills/customer-ops/shopify-admin-duplicate-customer-finder/ - **shopify-admin-email-deliverability-audit** — Read-only: scans the customer database for malformed emails, role accounts, disposable domains, and bounce-suspect patterns to protect sender reputation. https://skills.40rty.ai/skills/customer-ops/shopify-admin-email-deliverability-audit/ - **shopify-admin-marketing-consent-report** — Read-only: audits email and SMS marketing consent status across the customer base for compliance and segmentation. https://skills.40rty.ai/skills/customer-ops/shopify-admin-marketing-consent-report/ - **shopify-admin-rfm-customer-segmentation** — Read-only: scores every customer on Recency, Frequency, and Monetary value to segment them into actionable groups (Champions, Loyal, At-Risk, Lost). https://skills.40rty.ai/skills/customer-ops/shopify-admin-rfm-customer-segmentation/ ### 3.4 Customer Support (8) - **shopify-admin-address-correction** — Update the shipping address on an unfulfilled order before it ships. https://skills.40rty.ai/skills/customer-support/shopify-admin-address-correction/ - **shopify-admin-bulk-customer-tag-update** — Adds and/or removes tags across a filtered set of customers — supports query-based selection, explicit ID lists, and union/replace tag modes. https://skills.40rty.ai/skills/customer-support/shopify-admin-bulk-customer-tag-update/ - **shopify-admin-customer-merge** — 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. https://skills.40rty.ai/skills/customer-support/shopify-admin-customer-merge/ - **shopify-admin-customer-timeline-export** — 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. https://skills.40rty.ai/skills/customer-support/shopify-admin-customer-timeline-export/ - **shopify-admin-order-lookup-and-summary** — Retrieve and summarize full order details for a customer by email, order number, or phone number. https://skills.40rty.ai/skills/customer-support/shopify-admin-order-lookup-and-summary/ - **shopify-admin-refund-and-reorder** — Process a full or partial refund on an order and optionally create a replacement draft order for the customer. https://skills.40rty.ai/skills/customer-support/shopify-admin-refund-and-reorder/ - **shopify-admin-return-initiation** — Create a formal Shopify Return record for an order, specifying line items, quantities, and return reason — the first step in the native returns workflow. https://skills.40rty.ai/skills/customer-support/shopify-admin-return-initiation/ - **shopify-admin-wismo-bulk-status-report** — Identify orders at risk of generating WISMO support tickets: shipped orders with stale tracking, and unfulfilled orders past their SLA window. https://skills.40rty.ai/skills/customer-support/shopify-admin-wismo-bulk-status-report/ ### 3.5 Finance (12) - **shopify-admin-average-order-value-trends** — Read-only: tracks AOV over time buckets and segments by new vs. returning customers. https://skills.40rty.ai/skills/finance/shopify-admin-average-order-value-trends/ - **shopify-admin-discount-cost-trend** — Read-only: tracks total discount dollars given over configurable time buckets (week/month/quarter), broken down by discount type and code. https://skills.40rty.ai/skills/finance/shopify-admin-discount-cost-trend/ - **shopify-admin-gift-card-balance-report** — Read-only: lists all active gift cards with remaining balance, expiry, and last-used date for liability tracking. https://skills.40rty.ai/skills/finance/shopify-admin-gift-card-balance-report/ - **shopify-admin-gift-card-liability-report** — Read-only: calculates total outstanding gift card balance as a financial liability, broken down by issue cohort and remaining balance band. https://skills.40rty.ai/skills/finance/shopify-admin-gift-card-liability-report/ - **shopify-admin-payout-reconciliation** — Read-only: reconciles Shopify Payments payouts against the order transactions that funded them and flags amount discrepancies. https://skills.40rty.ai/skills/finance/shopify-admin-payout-reconciliation/ - **shopify-admin-profit-margin-calculator** — Read-only: calculates true net profit per order and per product by factoring in COGS, shipping costs, transaction fees, discounts, refunds, and taxes. https://skills.40rty.ai/skills/finance/shopify-admin-profit-margin-calculator/ - **shopify-admin-refund-rate-analysis** — Read-only: calculates refund rate by product, collection, or period — identifies quality and listing issues. https://skills.40rty.ai/skills/finance/shopify-admin-refund-rate-analysis/ - **shopify-admin-revenue-by-location-report** — Read-only: breaks down revenue by fulfillment location for multi-warehouse P&L and location performance. https://skills.40rty.ai/skills/finance/shopify-admin-revenue-by-location-report/ - **shopify-admin-sales-by-channel-report** — Read-only: breaks down revenue, units, and AOV by sales channel (Online Store, POS, Draft Orders, etc.). https://skills.40rty.ai/skills/finance/shopify-admin-sales-by-channel-report/ - **shopify-admin-shipping-cost-analysis** — Read-only: aggregates shipping revenue charged to customers vs. actual shipping line costs by carrier and method. https://skills.40rty.ai/skills/finance/shopify-admin-shipping-cost-analysis/ - **shopify-admin-subscription-mrr-tracker** — Read-only: for stores with subscription products, calculates MRR, ARR, active subscriber count, and rolling churn rate from subscription contracts. https://skills.40rty.ai/skills/finance/shopify-admin-subscription-mrr-tracker/ - **shopify-admin-tax-liability-summary** — Read-only: aggregates tax collected by jurisdiction from order tax lines for filing prep. https://skills.40rty.ai/skills/finance/shopify-admin-tax-liability-summary/ ### 3.6 Fulfillment Ops (11) - **shopify-admin-bulk-fulfillment-creation** — Batch-fulfill open fulfillment orders with tracking numbers. Supports partial fulfillment and customer notification toggle. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-bulk-fulfillment-creation/ - **shopify-admin-bundle-availability-check** — Read-only: for native bundle products and metafield-defined bundles, verifies every component variant has sufficient stock to fulfill the bundle's effective availability. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-bundle-availability-check/ - **shopify-admin-cancel-and-restock** — Cancel an unfulfilled order, optionally restock inventory, and optionally notify the customer — all in a single validated workflow. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-cancel-and-restock/ - **shopify-admin-carrier-performance-comparison** — Read-only: compares delivery times and shipping costs across carriers used in fulfillments to inform carrier mix and contract decisions. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-carrier-performance-comparison/ - **shopify-admin-delivery-time-analysis** — Read-only: calculates average time from fulfillment creation to delivery by carrier using fulfillment and order data. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-delivery-time-analysis/ - **shopify-admin-fulfillment-location-routing** — Reassign fulfillment orders from one location to another for warehouse overflow or regional routing. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-fulfillment-location-routing/ - **shopify-admin-fulfillment-status-digest** — Generate a daily fulfillment triage digest: all open orders segmented by fulfillment age and flagged for holds or exceptions. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-fulfillment-status-digest/ - **shopify-admin-order-hold-and-release** — Place or release fulfillment holds on open orders in batch — with a stated reason and optional expiry date. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-order-hold-and-release/ - **shopify-admin-shipping-rate-audit** — Read-only: walks every delivery profile and zone to verify each has at least one valid shipping rate, surfacing zones with no rates or only manual rates. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-shipping-rate-audit/ - **shopify-admin-split-shipment-planner** — Splits a multi-line fulfillment order into separate shipments for partial or location-specific shipping. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-split-shipment-planner/ - **shopify-admin-tracking-update-bulk** — Batch-update tracking numbers and URLs on existing fulfillments when a carrier reassigns tracking IDs. https://skills.40rty.ai/skills/fulfillment-ops/shopify-admin-tracking-update-bulk/ ### 3.7 Marketing (6) - **shopify-admin-abandoned-cart-recovery** — Query checkouts abandoned in the last N days, generate unique discount codes per customer, and tag them for re-engagement. https://skills.40rty.ai/skills/marketing/shopify-admin-abandoned-cart-recovery/ - **shopify-admin-customer-win-back** — Identify customers who have not ordered in N days, export a re-engagement list, and tag them in Shopify. https://skills.40rty.ai/skills/marketing/shopify-admin-customer-win-back/ - **shopify-admin-loyalty-segment-export** — Identify high-LTV customers by order count and lifetime spend, tag them, and export a loyalty-ready contact list. https://skills.40rty.ai/skills/marketing/shopify-admin-loyalty-segment-export/ - **shopify-admin-promo-code-bulk-generator** — Bulk-creates a batch of unique discount codes for campaigns, giveaways, or partner distributions — each code is its own DiscountCodeBasic with single-use limit by default. https://skills.40rty.ai/skills/marketing/shopify-admin-promo-code-bulk-generator/ - **shopify-admin-referral-source-attribution** — Read-only: parses each order's landing site and referrer URL to break down orders, revenue, and AOV by traffic source — direct, organic, paid, social, email, or referral domain. https://skills.40rty.ai/skills/marketing/shopify-admin-referral-source-attribution/ - **shopify-admin-vip-customer-identifier** — Identifies top-spending customers (top N% by lifetime value or order frequency) and exports a VIP candidate list; optionally tags qualified customers as VIPs. https://skills.40rty.ai/skills/marketing/shopify-admin-vip-customer-identifier/ ### 3.8 Merchandising (25) - **shopify-admin-bulk-price-adjustment** — Query products by collection or tag and update all variant prices by a percentage or fixed amount, with optional floor/ceiling constraints. https://skills.40rty.ai/skills/merchandising/shopify-admin-bulk-price-adjustment/ - **shopify-admin-cogs-completeness-audit** — Read-only: identifies products and variants that are missing inventoryItem.unitCost so margin and inventory valuation reports stay accurate. https://skills.40rty.ai/skills/merchandising/shopify-admin-cogs-completeness-audit/ - **shopify-admin-collection-membership-audit** — Read-only: lists orphan products (in zero collections) and over-collected products for catalog hygiene. https://skills.40rty.ai/skills/merchandising/shopify-admin-collection-membership-audit/ - **shopify-admin-collection-reorganization** — Reorder products in a manual Shopify collection by inventory level, moving in-stock products to the top and out-of-stock to the bottom. https://skills.40rty.ai/skills/merchandising/shopify-admin-collection-reorganization/ - **shopify-admin-compare-at-price-cleanup** — Removes stale compareAtPrice values where current price >= compareAtPrice (no real discount) or compareAtPrice has been set for over a configurable age threshold. https://skills.40rty.ai/skills/merchandising/shopify-admin-compare-at-price-cleanup/ - **shopify-admin-dead-stock-identifier** — Read-only: cross-references inventory levels with order velocity to flag items with positive stock but zero sales in N days. https://skills.40rty.ai/skills/merchandising/shopify-admin-dead-stock-identifier/ - **shopify-admin-demand-forecast-reorder** — Read-only: forecasts demand per SKU using sales velocity and seasonality, then calculates reorder points and suggested purchase order quantities. https://skills.40rty.ai/skills/merchandising/shopify-admin-demand-forecast-reorder/ - **shopify-admin-duplicate-sku-barcode-detector** — Read-only: finds duplicate SKUs or barcodes across all product variants. https://skills.40rty.ai/skills/merchandising/shopify-admin-duplicate-sku-barcode-detector/ - **shopify-admin-inventory-adjustment** — Apply inventory quantity adjustments to specific variants at specific locations — after a cycle count, 3PL return batch, or sync discrepancy correction. https://skills.40rty.ai/skills/merchandising/shopify-admin-inventory-adjustment/ - **shopify-admin-inventory-aging-report** — Read-only: categorizes inventory into aging buckets (0-30, 31-60, 61-90, 90+ days) based on time since last sale or receipt. https://skills.40rty.ai/skills/merchandising/shopify-admin-inventory-aging-report/ - **shopify-admin-inventory-transfer-between-locations** — Moves inventory units from one location to another by decrementing the source and incrementing the destination. https://skills.40rty.ai/skills/merchandising/shopify-admin-inventory-transfer-between-locations/ - **shopify-admin-inventory-valuation-report** — Read-only: calculates total inventory value (quantity × cost) per location and per vendor for accounting and insurance. https://skills.40rty.ai/skills/merchandising/shopify-admin-inventory-valuation-report/ - **shopify-admin-low-inventory-restock** — Query all tracked product variants below a stock threshold and export a restock list grouped by vendor. https://skills.40rty.ai/skills/merchandising/shopify-admin-low-inventory-restock/ - **shopify-admin-metafield-bulk-update** — Bulk set or delete metafields on products, variants, or customers filtered by tag or collection. https://skills.40rty.ai/skills/merchandising/shopify-admin-metafield-bulk-update/ - **shopify-admin-multi-location-inventory-audit** — Audit inventory levels across all active locations, flagging variants where Available quantity is negative or Committed exceeds On Hand — a signal of inventory sync drift. https://skills.40rty.ai/skills/merchandising/shopify-admin-multi-location-inventory-audit/ - **shopify-admin-price-elasticity-analyzer** — Read-only: analyzes the relationship between product pricing and sales velocity to identify optimal price points and price-sensitive products. https://skills.40rty.ai/skills/merchandising/shopify-admin-price-elasticity-analyzer/ - **shopify-admin-product-data-completeness-score** — Read-only: scores each product on data completeness across description, images, SEO, weight, barcode, cost, and metafields. https://skills.40rty.ai/skills/merchandising/shopify-admin-product-data-completeness-score/ - **shopify-admin-product-image-audit** — Read-only: flags products and variants with missing images or fewer than a minimum number of images. https://skills.40rty.ai/skills/merchandising/shopify-admin-product-image-audit/ - **shopify-admin-product-lifecycle-manager** — Bulk transition products through DRAFT → ACTIVE → ARCHIVED status for seasonal launches and sunsetting. https://skills.40rty.ai/skills/merchandising/shopify-admin-product-lifecycle-manager/ - **shopify-admin-product-tag-bulk-update** — Add or remove tags on all products matching a collection, existing tag, or search query — for campaign setup, teardown, or catalog organization. https://skills.40rty.ai/skills/merchandising/shopify-admin-product-tag-bulk-update/ - **shopify-admin-seo-metadata-audit** — Read-only: scans products, collections, and pages for missing SEO titles or meta descriptions. https://skills.40rty.ai/skills/merchandising/shopify-admin-seo-metadata-audit/ - **shopify-admin-stock-velocity-report** — Read-only: calculates days-of-supply and sell-through rate per SKU and location for replenishment planning. https://skills.40rty.ai/skills/merchandising/shopify-admin-stock-velocity-report/ - **shopify-admin-variant-option-normalizer** — Detects inconsistent variant option naming (Sm vs Small vs S) and bulk-corrects to a standard set. https://skills.40rty.ai/skills/merchandising/shopify-admin-variant-option-normalizer/ - **shopify-admin-variant-performance-report** — Rank every product variant by revenue, units sold, and refund rate, then cross-reference against current inventory to identify dead weight vs. top performers. https://skills.40rty.ai/skills/merchandising/shopify-admin-variant-performance-report/ - **shopify-admin-vendor-consolidation** — Read-only: detects vendor field typos, casing variants, and trailing-whitespace duplicates across the catalog and proposes a canonical merge per cluster. https://skills.40rty.ai/skills/merchandising/shopify-admin-vendor-consolidation/ ### 3.9 Order Intelligence (9) - **shopify-admin-automated-order-tagger** — Mutation: applies tags to orders based on configurable rules (geography, value, product type, risk level, customer tier). https://skills.40rty.ai/skills/order-intelligence/shopify-admin-automated-order-tagger/ - **shopify-admin-high-risk-order-tagger** — Tags orders flagged as high-risk for manual review and optionally places fulfillment holds to prevent shipping. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-high-risk-order-tagger/ - **shopify-admin-order-attribution-report** — Read-only: parses UTM source/medium/campaign from order landing site URLs to attribute revenue, AOV, and conversion volume to marketing channels. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-order-attribution-report/ - **shopify-admin-order-cancellation-analysis** — Read-only: tracks cancellation rate over time and breaks down cancelled orders by cancelReason to surface fraud, inventory, customer, and declined-payment patterns. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-order-cancellation-analysis/ - **shopify-admin-order-notes-and-attributes-report** — Read-only: extracts and tabulates order notes and custom attributes for ops review of gift messages and special instructions. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-order-notes-and-attributes-report/ - **shopify-admin-order-risk-report** — Read-only: lists orders by fraud risk level with indicator details for building a manual review queue. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-order-risk-report/ - **shopify-admin-partial-refund-pattern-detector** — Read-only: surfaces orders with multiple partial refunds or unusually high partial-refund-to-total ratios that may indicate fraud, chronic complaints, or process gaps. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-partial-refund-pattern-detector/ - **shopify-admin-product-affinity-cross-sell** — Mine order history to find which products are most frequently bought together, then rank pairs by support, confidence, and lift to power bundles and cross-sell recommendations. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-product-affinity-cross-sell/ - **shopify-admin-repeat-purchase-rate** — Read-only: calculates what percentage of customers place 2+ orders within N days, segmented by product or collection. https://skills.40rty.ai/skills/order-intelligence/shopify-admin-repeat-purchase-rate/ ### 3.10 Returns (6) - **shopify-admin-exchange-vs-refund-ratio** — Read-only: tracks what percentage of returns become exchanges vs. refunds vs. store credit — measures revenue recovery rate. https://skills.40rty.ai/skills/returns/shopify-admin-exchange-vs-refund-ratio/ - **shopify-admin-restock-on-return** — For approved/closed returns, restocks inventory at the return location by adjusting on-hand quantities for each returned line item. https://skills.40rty.ai/skills/returns/shopify-admin-restock-on-return/ - **shopify-admin-return-cost-attribution** — Read-only: calculates the true cost of returns by reason and product — refund dollars, restocking impact, shipping cost lost, and COGS impact for items written off. https://skills.40rty.ai/skills/returns/shopify-admin-return-cost-attribution/ - **shopify-admin-return-fraud-detector** — Read-only: identifies customers with abnormal return behavior — high return rate, wardrobing patterns, or serial returner profiles — for manual review. https://skills.40rty.ai/skills/returns/shopify-admin-return-fraud-detector/ - **shopify-admin-return-processing-sla** — Read-only: measures average time from return request to refund completion, surfacing SLA breaches. https://skills.40rty.ai/skills/returns/shopify-admin-return-processing-sla/ - **shopify-admin-return-reason-analysis** — Read-only: aggregates return reasons across orders to identify product quality or listing issues. https://skills.40rty.ai/skills/returns/shopify-admin-return-reason-analysis/ ### 3.11 Store Management (8) - **shopify-admin-discount-hygiene-cleanup** — Finds expired, zero-usage, or duplicate discount codes and optionally deactivates or deletes them. https://skills.40rty.ai/skills/store-management/shopify-admin-discount-hygiene-cleanup/ - **shopify-admin-draft-order-cleanup** — Finds stale draft orders older than N days and optionally deletes them to reduce admin clutter. https://skills.40rty.ai/skills/store-management/shopify-admin-draft-order-cleanup/ - **shopify-admin-file-storage-audit** — Read-only: lists every file in CDN storage, cross-references usage on products, pages, and articles, and flags orphaned/unreferenced assets. https://skills.40rty.ai/skills/store-management/shopify-admin-file-storage-audit/ - **shopify-admin-metafield-definition-audit** — Read-only: enumerates every metafield definition across all owner types and flags unused, undocumented, or duplicate-key definitions. https://skills.40rty.ai/skills/store-management/shopify-admin-metafield-definition-audit/ - **shopify-admin-page-content-audit** — Read-only: lists all pages and blog posts, flags empty or short content and missing SEO fields. https://skills.40rty.ai/skills/store-management/shopify-admin-page-content-audit/ - **shopify-admin-publication-channel-audit** — Read-only: shows which products are published to which sales channels and flags unpublished active products. https://skills.40rty.ai/skills/store-management/shopify-admin-publication-channel-audit/ - **shopify-admin-staff-account-audit** — Read-only: reviews staff accounts for stale logins, inactive status, and overpermissioned roles to surface security and access hygiene issues. https://skills.40rty.ai/skills/store-management/shopify-admin-staff-account-audit/ - **shopify-admin-url-redirect-audit** — Read-only: lists all URL redirects, flags redirect chains (A→B→C) and duplicate targets. https://skills.40rty.ai/skills/store-management/shopify-admin-url-redirect-audit/ --- ## 4. Routines Reference (23 scheduled agents) Routines are always-on agents installed via `mcp__scheduled-tasks__create_scheduled_task`. They run on a cron, profile your store, and alert when thresholds are breached. | Routine | Schedule (cron) | Purpose | |---------|-----------------|---------| | INSTALL | `` | | | README | `` | | | Abandoned Cart Patrol | `0 */4 * * *` | Every 4 hours — scans for abandoned checkouts and reports recovery opportunities. | | Agentic Readiness Monitor | `0 9 * * 1` | Weekly Agentic Commerce Readiness check — re-scores the catalog for AI-agent findability and alerts when new gaps appear (lost barcodes, blank alt text, reset robots rules). | | Catalog Health Weekly | `0 7 * * 3` | Wednesdays — comprehensive product data quality scan. | | Customer Churn Watch | `0 8 * * 3` | Weekly — identifies at-risk and churning customers with win-back recommendations. | | Dead Stock Weekly | `0 9 * * 0` | Sundays — identify dead stock and generate markdown candidates report. | | Discount Roi Weekly | `0 9 * * 2` | Tuesdays — review discount code performance and flag underperforming campaigns. | | Fraud Sentinel | `0 */2 * * *` | Every 2 hours — scans recent orders for fraud indicators and flags high-risk orders. | | Fulfillment Sla Watchdog | `0 10,15 * * 1-5` | Twice daily on weekdays — checks for overdue fulfillments and stalled shipments. | | Inventory Aging Monthly | `0 7 15 * *` | 15th of each month — inventory aging buckets with carrying cost analysis. | | Low Stock Watchdog | `0 7 * * *` | Daily inventory scan — alerts when products drop below reorder point based on sales velocity. | | Monthly Financial Close | `0 8 1 * *` | First of every month — comprehensive financial close report with P&L, payouts, taxes, and refunds. | | Morning Store Briefing | `0 8 * * *` | Daily morning digest — orders, revenue, fulfillment status, and issues from the last 24 hours. | | New Product Launch Tracker | `0 10 * * *` | Daily — tracks first-week performance of recently published products. | | Payout Recon Daily | `0 6 * * *` | Daily — reconciles Shopify Payments payouts against orders, flags discrepancies. | | Price Anomaly Scanner | `0 6 * * *` | Daily early morning — scans for pricing errors, zero-price products, and compare-at-price inconsistencies. | | Quarterly Business Review | `0 9 1 1,4,7,10 *` | First day of each quarter — comprehensive QBR with trends, cohorts, top movers, and strategic insights. | | Return Fraud Watch | `0 9 * * 1` | Mondays — scans for suspicious return patterns and serial returners. | | Seo Coverage Weekly | `0 7 * * 4` | Thursdays — SEO metadata gap report across catalog. | | Staff Activity Monthly | `0 10 1 * *` | First of each month — staff account audit and permission review. | | Vip Customer Watcher | `0 9 * * *` | Daily — alerts on VIP customer orders, issues, or churn risk for white-glove handling. | | Weekly Business Review | `0 8 * * 1` | Monday morning — comprehensive weekly performance report across all store dimensions. | --- ## 5. Technical Details ### Compatibility - **Claude** (claude.ai web + desktop) - **Claude Code** (CLI) - **Claude Cowork** (team workspace) - **Cursor** - **Cline** - **GitHub Copilot** - **Gemini CLI** - Any agent supporting the `npx skills` protocol or MCP tool calling ### How Skills Work Each skill is a SKILL.md file containing: - Structured frontmatter (name, description, category, required scopes) - Step-by-step agent instructions using Shopify Admin GraphQL - Output format specification - Error handling guidance Agents read the skill file, authenticate with the merchant's Shopify store, execute the GraphQL operations, and return results as a clean human-readable summary. ### Data & Privacy - Skills run locally in the merchant's AI agent - No data is sent to 40rty servers - Shopify API credentials are stored locally by the agent - All operations use the official Shopify Admin API — no scraping ### License MIT — free to use, fork, and extend. --- ## 6. Frequently Asked Questions **What AI agents does this work with?** Claude (claude.ai), Claude Code (CLI), Claude Cowork, Cursor, Cline, GitHub Copilot, Gemini CLI, and any MCP-compatible agent. **Is this free?** Yes. Fully open source under MIT. No account, no credit card, no usage limits imposed by 40rty. **What is a skill vs a routine?** A skill is an on-demand workflow you trigger manually ("find abandoned carts from the last 7 days"). A routine is a scheduled agent that runs automatically on a cron (e.g. every morning). **Does it change my Shopify store automatically?** Only when you explicitly ask it to. Read operations (audits, reports) are always safe. Write operations (refunds, price changes, fulfillments) require the agent to propose changes and wait for your confirmation. **How is this different from Shopify Flow?** Shopify Flow runs rule-based automations. Shopify Admin Skills uses language model reasoning — your agent interprets open-ended requests, adapts to context, and handles edge cases that rules cannot anticipate. **What Shopify plan do I need?** Skills work on all Shopify plans. Some features (B2B, multi-location inventory) require Shopify Plus. **How do I request a new skill?** Open a GitHub issue at https://github.com/40RTY-ai/shopify-admin-skills or email the 40rty team via https://40rty.ai. **Who built this?** 40rty — the team behind AgentIQ, the Answer Engine Optimization (AEO) platform that helps Shopify merchants get their products selected by ChatGPT, Perplexity, Gemini, and other AI shopping agents. --- ## 7. Use Case Queries (semantic search intents) - "Shopify AI agent automation" - "Claude Code Shopify skills" - "Claude Cowork Shopify integration" - "AI agent Shopify store management" - "automate Shopify with AI" - "Shopify abandoned cart recovery AI agent" - "Shopify inventory audit AI" - "Shopify fraud detection AI" - "Claude Shopify Admin API" - "Shopify MCP tools" - "AI skills npx install" - "Shopify scheduled AI routines" - "open source Shopify automation" - "Shopify AI reporting agent" - "Cursor Shopify plugin" - "Cline Shopify integration" - "allow AI crawlers on my Shopify store" --- ## 8. Related Products **AgentIQ by 40rty** — the commercial Shopify app that optimizes your product catalog for AI-driven product discovery and Answer Engine Optimization (AEO). Makes your products visible and selectable by ChatGPT, Perplexity, Gemini, and Copilot. - Site: https://40rty.ai - Shopify App Store: https://apps.shopify.com/fourty-ai - Free AI visibility audit for any storefront: https://audit.40rty.ai --- ## 9. Source & Links - Skills site: https://skills.40rty.ai - Skills directory: https://skills.40rty.ai/skills/ - Routines directory: https://skills.40rty.ai/routines/ - Sitemap: https://skills.40rty.ai/sitemap-index.xml - GitHub: https://github.com/40RTY-ai/shopify-admin-skills - Summary (llms.txt): https://skills.40rty.ai/llms.txt - 40rty main site: https://40rty.ai - 40rty llms.txt: https://40rty.ai/llms.txt - License: MIT