shopify/shopify-ai-toolkit
22 skills93.3k installs8.2k starsGitHub
Install
npx skills add https://github.com/shopify/shopify-ai-toolkitSkills in this repo
1Shopify AdminShopify-admin is an agent skill from Shopify’s AI toolkit for solo builders and indie app developers who integrate with merchant Admin APIs instead of guessing GraphQL shapes from memory. The bundled implementation centers on a Node search_docs script, shared HTTP resolution for production shopify.dev, shop.dev, and optional numbered staging hosts on shopifycloud.com, plus a fixed list of supported API version strings agents should respect when generating queries. When you point agents at staging, the skill enforces that SHOPIFY_DEV_STAGING_SERVER_NUMBER is a safe positive integer and surfaces how to obtain MINERVA_TOKEN for Minerva-protected staging audiences. Use it during Build when you are wiring ecommerce backends, custom apps, or internal ops tools that read orders, products, or metafields. It is an integration helper, not a substitute for Shopify’s partner compliance review or production OAuth app certification steps.6.1kinstalls2Shopify LiquidShopify Liquid is an agent skill aimed at solo builders and small teams customizing Shopify themes—especially hero banners and modular blocks in the Online Store 2.0 model. It encodes practical Liquid patterns: documenting blocks with `{% doc %}`, rendering slides via `content_for`, binding storefront settings to HTML and inline styles, and serving images through Shopify’s CDN helpers with mobile breakpoints. You reach for it when you are building or refactoring theme sections rather than wiring checkout or admin apps, and when you want consistent accessibility-minded structure (semantic headings, alt text on images) aligned with Shopify’s block APIs. The skill reduces trial-and-error around image pipelines, overlay treatments, and editor-facing attributes so generated markup is closer to what theme reviewers and merchants expect in production catalogs.5.9kinstalls3Shopify Devshopify-dev is Shopify’s general documentation search skill for coding agents building on the platform. Solo and indie builders shipping storefronts, apps, or automations install it when questions span multiple Shopify surfaces or when no narrower skill in the toolkit fits the task. The workflow is strict: run the bundled search script with model and client identifiers, query by feature or API topic, then answer from retrieved shopify.dev context instead of model memory. It complements—not replaces—skills like shopify-admin-graphql or shopify-liquid. Use it during integration-heavy Build work when you need accurate field names, examples, and API patterns across the doc corpus.5.6kinstalls4Shopify Storefront GraphqlShopify Storefront GraphQL is a Shopify AI Toolkit skill aimed at solo builders shipping headless or custom storefront experiences. Rather than guessing field names and API version deprecations, the skill orients agents around the Storefront GraphQL surface and pairs that with doc-search automation wired to shopify.dev (and optional staging hosts with Minerva authentication). Supported API version lists help agents pick stable calendar versions instead of defaulting to breaking unstable shapes. For an indie developer building a Next.js or mobile shop, this reduces integration churn—carts, products, and collections queries align with Shopify's current schema documentation. Install it when you are actively coding Storefront API clients, debugging GraphQL errors, or scaffolding a new commerce integration during the build phase.5.4kinstalls5Shopify Custom DataShopify Custom Data is an agent skill from Shopify’s AI toolkit aimed at solo builders and small teams extending Shopify with structured merchant data. Use it during Build when you need metafields, metaobjects, or related Admin API patterns instead of guessing schema rules and access scopes. The skill sits in the integrations lane of the journey because it connects your app or agent workflow to Shopify’s platform contracts rather than generic UI work. Prism lists it for ecommerce and API-shaped products where custom attributes power merchandising, B2B fields, or app-specific configuration. Because published SKILL.md in the ingest snapshot is thin, treat highlights as capability framing and confirm behavior against current shopify.dev custom-data docs before relying on edge-case guidance.5.3kinstalls6Shopify FunctionsShopify-functions is an agent skill from the Shopify AI toolkit that helps solo and indie builders implement Shopify Functions—the WASM-based extension points merchants use for discounts, cart transforms, delivery customization, payment customization, and similar checkout-adjacent logic. It is meant for developers who already chose Shopify as the commerce platform and need procedural guidance instead of guessing at extension targets, input/output shapes, and deployment steps. The toolkit wires documentation lookup against shopify.dev (with optional staging hosts for Shopify engineers), so answers stay aligned with official references rather than stale blog posts. Use it during the build phase when you are wiring backend integration work into a Shopify app: defining function metadata, matching API versions, and validating behavior before you ship to partners or production shops. It does not replace the Shopify CLI or Partner Dashboard, but it compresses the research loop so your coding agent can propose implementations that respect Shopify’s function model and app extension boundaries.5.3kinstalls7Shopify Polaris App Homeshopify-polaris-app-home is part of Shopify’s AI toolkit for developers shipping embedded apps. It orients coding agents toward the App Home experience inside Shopify Admin—where merchants configure your app—using Polaris conventions and the correct GraphQL/admin API release lines. The skill material includes version metadata across admin, storefront GraphQL, partner, customer, and payments-apps APIs so implementations target supported calendar versions instead of stale or unstable-only endpoints. Solo and indie builders building Shopify app store products get guardrails that reduce “works in dev, rejected in review” friction from wrong API versions or non-admin UI patterns. Invoke when you are implementing settings pages, onboarding cards, or primary app surfaces that must feel native to Admin. It is a domain integration guide, not a substitute for Shopify Partner account setup, OAuth, or App Store compliance review.5kinstalls8Shopify Customershopify-customer is part of Shopify’s AI toolkit: agent-oriented scripts that sit next to Shopify’s HTTP and documentation utilities so you can implement customer-related Admin API workflows without re-scaffolding auth, hosts, and version strings every session. The visible bundle emphasizes environment-aware base URLs—production shopify.dev endpoints, optional staging hosts keyed by server number, and explicit Minerva token requirements when you target staging—plus shared constants for supported API version identifiers. Solo merchants and indie app builders use it while connecting CRM-style automations, support agents, or internal ops tools to live shop data. It is not a full theme or checkout skill; it is backend integration glue with doc search affordances. Expect Node, Shopify partner or shop credentials in your wider setup, and validate which customer mutations and queries your exact script exports because the Prism excerpt is truncated minified source rather than a full command catalog.4.9kinstalls9Shopify Polaris Admin ExtensionsShopify Polaris Admin Extensions is an agent skill from Shopify’s AI toolkit that grounds your coding agent in how to work on admin UI extensions with Polaris while respecting Shopify’s versioned API surface. Solo builders and indie app developers shipping on the Shopify App Store install it when extension targets, GraphQL admin operations, or partner API calls must align with a specific quarterly release rather than guesswork. The bundled metadata reads as a structured API version manifest across admin, storefront GraphQL, partner, customer, and payments-apps channels, highlighting unstable tracks, release candidates, and which dated line is marked latest—information agents often get wrong from stale training data. Use it during Build when scaffolding extension entry points, wiring admin blocks or actions, or updating an existing app before Shopify deprecates an older API window. It complements hands-on Shopify CLI projects and is not a substitute for Shopify’s partner dashboard policies or app review guidelines, but it keeps implementation prompts anchored to the same version keys Shopify documents publicly.4.8kinstalls10Shopify Polaris Checkout ExtensionsShopify Polaris Checkout Extensions is a phase-specific agent skill from Shopify’s AI toolkit for solo builders and small teams shipping ecommerce apps and checkout customizations. It orients your agent around Shopify’s versioned API landscape—Admin, Storefront GraphQL, Partner, Customer, and Payments Apps—so extension code targets a deliberate release line instead of whatever the model remembers. You reach for it when you are building checkout UI extensions, wiring Polaris components, or aligning app configuration with current stable, release-candidate, or unstable channels. The embedded version matrix highlights practical anchors such as 2026-04 as latest and 2026-07 as release candidate, which matters for compliance reviews and app store submission timelines. It does not replace Shopify’s official docs but compresses version selection and extension context so Claude Code, Cursor, or Codex sessions stay on-policy. Expect integration-focused guidance rather than generic React styling.4.7kinstalls11Shopify HydrogenShopify Hydrogen is an agent skill from Shopify’s AI toolkit that orients solo builders and small teams around headless commerce implementation on Hydrogen—the React/Remix stack for custom storefronts backed by the Storefront API. Install it when you are in Build and need consistent guidance on which Admin, Storefront GraphQL, Partner, Customer, and Payments Apps API versions to target, instead of guessing from scattered docs. The embedded catalog lists unstable, release-candidate, and dated stable lines so your agent can generate loaders, routes, and integration code against a single version baseline. It matters for indie merchants and dev shops who want performance and branding control without Shopify’s default theme constraints. Pair it with your Hydrogen repo, Shopify CLI workflow, and deployment target (e.g. Oxygen). It is reference-oriented integration knowledge, not a substitute for security review or full theme migration planning.4.7kinstalls12Shopify Polaris Customer Account ExtensionsShopify Polaris Customer Account Extensions is an agent skill in Shopify’s AI toolkit for solo builders and micro-teams extending the logged-in customer experience on Shopify—not the legacy order status page, but the newer customer account surfaces where Polaris components and extension APIs apply. Use it during Build when you are wiring UI blocks, settings, or workflows inside customer account and need the same API version discipline as admin and partner apps. The skill’s reference structure mirrors Shopify’s versioned API families so your agent does not hallucinate deprecated endpoints or mismatched calendar versions. It is most valuable when you sell on Shopify and want bespoke post-purchase UX (subscriptions, loyalty, support widgets) without forking checkout. Expect integration-heavy guidance rather than full app onboarding or App Store listing copy. Combine with Shopify CLI, extension scaffolding, and your app’s OAuth and deployment pipeline.4.7kinstalls13Shopify Payments AppsShopify Payments Apps is an integration skill from Shopify’s AI toolkit that helps solo merchants and indie agencies implement payment extensions without drowning in sprawling Shopify.dev documentation. It wires agents to search official docs with version-aware endpoints, including production and optional staging bases when you are testing against Shopify’s staging cloud. Use it during Build when you are scaffolding a payments app, debugging webhook or session flows, or aligning GraphQL and REST calls to a supported API release. The skill emphasizes live documentation retrieval over hallucinated endpoint shapes, which matters because payments compliance and API versioning change frequently. It assumes you already have a Shopify Partner context and app credentials mindset even if the agent only runs read-only doc queries. Treat network access and any staging tokens as sensitive, and pair outputs with Shopify’s own review checklist before submitting to the app store.4.7kinstalls14Shopify Pos UiShopify POS UI is an agent skill for solo and indie builders shipping in-store retail experiences on Shopify’s POS extension platform. It steers development toward official POS UI components and CLI scaffolding so smart-grid and customer-detail blocks feel native to merchants’ registers. The skill enforces a procedural gate: query documentation with the bundled search script, implement against the returned APIs, then pass the validate script with the correct point-of-sale extension target and client metadata before returning code. That pattern reduces hallucinated extension APIs and catches target mismatches early—critical when POS targets are strict and failures block merchant workflows. It fits builders already on Node.js who extend Shopify rather than greenfield apps. It is not a general e-commerce theme skill or checkout-only web work; scope is POS UI extensions and retail UX. Expect intermediate familiarity with Shopify CLI, extension targets, and Node tooling.4.5kinstalls15Shopify Partnershopify-partner is an agent skill from Shopify’s AI toolkit aimed at builders shipping on the Partner ecosystem who need fast, accurate answers from shopify.dev without tab-hopping. When you are wiring webhooks, GraphQL Admin API calls, app extensions, or billing flows, the skill’s search and HTTP helpers keep queries aligned to supported API versions and the correct documentation base URL—including staging when MINERVA_TOKEN and server number env vars are set. Solo merchants-turned-developers and indie app authors benefit because the agent can ground replies in official docs rather than stale blog posts. It is narrower than a full app scaffold generator: it accelerates research and partner-correct API usage during implementation. Pair it with your own project skills for theme or checkout customization once you know which API surfaces apply.4.4kinstalls16Shopify App Store ReviewShopify App Store Review is an agent skill from Shopify’s AI toolkit that helps solo and indie builders stress-test a Shopify app as if it were entering App Store review. Install it when your app mostly works in development or staging but you still worry about policy, authentication, billing, data handling, or embedded-admin experience failing human or automated checks. The skill steers your coding agent through a structured readiness pass over your codebase and listing assumptions, highlighting gaps that commonly delay approval or trigger resubmission loops. It is aimed at Partner Dashboard workflows—extensions, embedded apps, and SaaS-style integrations—not generic theme tweaks or storefront-only changes. Because official SKILL.md prose was not available in this ingest payload, treat capabilities as name- and domain-aligned guidance; re-run tagging once the full skill body is on disk. Expect intermediate familiarity with Shopify CLI, app URLs, and billing APIs.3.8kinstalls17Shopify Onboarding DevShopify Onboarding Dev is an agent skill aimed at solo and indie builders shipping Shopify apps, themes, or automation who must hit the right dev endpoints on the first try. Staging Shopify documentation servers sit behind Minerva, and misconfigured base URLs or missing cookies produce opaque auth failures that waste hours. The skill encodes how production shopify.dev URLs differ from shop.dev and per-server staging hosts, when to inject MINERVA_TOKEN cookies, and how to obtain tokens with devx minerva-auth for a specific audience. Use it at the start of a Shopify integration sprint in Build—not for storefront merchandising or launch SEO. After onboarding, you can point agents and local scripts at a validated environment so subsequent toolkit skills assume consistent HTTP behavior and logging.3.7kinstalls18Shopify Use Shopify Clishopify-use-shopify-cli is an agent skill from Shopify’s AI toolkit that keeps solo builders on the supported path when developing on Shopify—using the CLI and shopify.dev surfaces rather than guessing URLs or auth. It matters when you are building ecommerce integrations: spinning up app dev, hitting the right documentation host, or targeting a staging Shopify Cloud server that sits behind Minerva. The embedded guidance encodes environment rules (staging server numbers, token cookies, instrumentation overrides) so automated runs fail fast with copy-paste fixes instead of opaque 401s. Pair it with other toolkit skills for GraphQL, extensions, and theme work. You reach for it during Build integrations whenever your agent needs to run Shopify CLI commands, align local env with Shopify’s dev/staging matrix, or log skill usage against Shopify’s agent-skill instrumentation—especially if you are one person wearing app, backend, and merchant-facing hats.3.1kinstalls19Shopify Onboarding MerchantShopify-onboarding-merchant guides store owners—not app developers—through installing the Shopify CLI, detecting their operating system, connecting a shop, and taking first merchant actions from Claude Code, Claude Desktop, or Cursor. The skill insists on plain language: when uncertain, ask the merchant instead of guessing, and keep developer concepts out of the conversation. Invocation breadth is wide: new store setup, plugin connection, catalog import, and replatforming from major marketplaces and POS systems named in the description. Each step is procedural (detect OS, verify CLI, install if missing, connect store) so agents act as patient store assistants rather than code generators. It assumes the user wants to start selling online and may need hand-holding through terminal commands appropriate to their platform. It is inappropriate for custom app development, theme coding, or Admin API integrations—that is a different audience. Pair with Shopify’s merchant tools after connection for day-to-day product and order management.3kinstalls20Shopify Admin Executionshopify-admin-execution teaches agents to treat “my store” requests as executable Shopify CLI workflows, not detached GraphQL homework. Solo builders and small Shopify app teams use it when they need the first ten products, low-inventory SKUs, or warehouse-level inventory changes on a specific shop domain. The skill emphasizes validated Admin GraphQL, store authentication, and shopify store execute as the default path—even for read-only merchant questions—so answers match what a developer can actually run locally. It fits merchants customizing ops scripts and partners building automation, but it assumes CLI tooling and appropriate store access rather than theme-only editing. Use when the user names a store or wants live data mutation, not when they only need generic API schema education.1.8kinstalls21UcpThe UCP skill teaches agents to act on buyer commercial intent using Shopify’s Universal Commerce Protocol CLI. It is aimed at solo builders shipping AI shopping assistants, browser agents, or internal tools that must discover products across a bundled catalog, compare options under budget constraints, and transact against UCP-capable merchants. Setup and troubleshooting for local UCP profiles sit alongside day-to-day operations: carts, checkout, orders, and help commands. When a merchant cannot complete checkout in-protocol, the skill prescribes falling back to the merchant’s own flow instead of failing the session. Scope is deliberately CLI- and protocol-centric—agents need the `ucp` binary installed and should follow the packaged routing table before improvising shell calls. Ideal when your product already positions the agent as a buyer; skip it for storefront-only apps with no agent-driven purchase path.1.3kinstalls22Shopify Merchant OnboardingShopify merchant onboarding is an agent skill that tells your assistant to fetch and follow Shopify’s live merchant SKILL.md at shopify.com/SKILL.md step by step. It is built for solo and indie store owners who want to set up or connect a shop, install the Shopify plugin, authenticate, and route into tasks like adding products or migrating a catalog—not for developers building Shopify apps or themes. Triggers match plain-language merchant intent: set up my store, connect Shopify, start selling online, import products, or move off Square, WooCommerce, Etsy, and similar platforms. Because onboarding spans deciding to sell, connecting systems, and going live, tags treat it as multi-phase with the primary shelf in build integrations. The skill runs as a forked context workflow and keeps the canonical flow on Shopify’s hosted instructions so behavior stays aligned with Shopify’s current merchant playbook.643installs