← ShopifyCONTENT HISTORYWHAT CHANGED · RULE-BASED ANALYSIS
Update to Shopify
Snapshot Sep 30, 2026 · 22:43 UTC · version 4.1.1
Collection source: not recorded for this historical snapshot.
First saved snapshot
No earlier snapshot is available to establish a change.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"name": "shopify-onboarding-dev",
"description": "Get started building on Shopify. Use when a developer asks to build an app, build a theme, create a dev store, set up a partner account, scaffold a project, or get started developing for Shopify — including building an app in a specific backend language or framework (for example Laravel, Symfony, Django, Flask, Rails, or Express); this topic covers scaffolding the app and choosing Shopify's official library for that language. When the prompt also involves an extension surface (checkout, admin, POS, customer accounts), learn this topic **in addition to** the surface topic. NOT for merchants managing stores.",
"included_files": [],
"skill_md_contents": "---\nname: shopify-onboarding-dev\ndescription: \"Get started building on Shopify. Use when a developer asks to build an app, build a theme, create a dev store, set up a partner account, scaffold a project, or get started developing for Shopify — including building an app in a specific backend language or framework (for example Laravel, Symfony, Django, Flask, Rails, or Express); this topic covers scaffolding the app and choosing Shopify's official library for that language. When the prompt also involves an extension surface (checkout, admin, POS, customer accounts), learn this topic **in addition to** the surface topic. NOT for merchants managing stores.\"\ncompatibility: Requires Node.js and Shopify CLI\nmetadata:\n author: Shopify\n version: \"1.15.0\"\n---\n\n## Flow\n\n### Step 1 — Detect environment\n\nSilently identify the client from system context:\n\n| Signal | Client |\n| ------------------------------- | ------------- |\n| \"Claude Code\" | `claude-code` |\n| \"Cursor\" | `cursor` |\n| \"VSCode\" / \"Visual Studio Code\" | `vscode` |\n| \"Gemini CLI\" | `gemini-cli` |\n| Unrecognized | `other` |\n\nIf genuinely uncertain about client, ask. Never guess.\n\n### Step 2 — Install prerequisites\n\nCheck if Shopify CLI is installed by running `shopify version`.\nIf the CLI is present and the AI toolkit plugin is already available,\nskip to Step 3.\n\n**Shopify CLI** — if not found, install using your package manager\n(npm, pnpm, yarn, and bun all work):\n\n```\nnpm install -g @shopify/cli@latest\n```\n\nIf no Node package manager is available, use Homebrew (macOS only):\n\n```\nbrew tap shopify/shopify && brew install shopify-cli\n```\n\nVerify with `shopify version` before continuing.\n\n**AI toolkit plugin/extension** — install for the detected client:\n\n| Client | Install command |\n| ------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| `claude-code` | `/plugin marketplace add Shopify/shopify-ai-toolkit` then `/plugin install shopify-plugin@shopify-ai-toolkit` |\n| `cursor` | `/add-plugin` and search for \"Shopify\", or visit `cursor.com/marketplace/shopify` |\n| `vscode` | Command Palette (Cmd+Shift+P) → **Chat: Install Plugin From Source** → paste `https://github.com/Shopify/Shopify-AI-Toolkit` |\n| `gemini-cli` | `gemini extensions install https://github.com/Shopify/shopify-ai-toolkit` (run in terminal, not inside CLI) |\n| `other` | Not supported — inform the user and stop |\n\nIf install fails, report the exact error and stop.\n\n### Step 3 — Post-install\n\nConfirm what was installed in one sentence. If the developer hasn't\nmentioned a specific goal yet, ask:\n\n> \"What would you like to build?\n>\n> 1. An app for Shopify\n> 2. A theme for Shopify\n>\n> Or if you need a developer account first, create one free at\n> [dev.shopify.com/dashboard](https://dev.shopify.com/dashboard).\"\n\nFrom here, let the developer's request flow to the appropriate\nAPI-specific skill (e.g. `shopify-admin`, `shopify-liquid`,\n`shopify-functions`). Do not duplicate their routing logic.\n\nFor development-store actions, create one with `shopify store create dev` and delete one with `shopify store delete --force`.\n\n### Official backend libraries\n\nUse official libraries for authenticating backend requests:\n\n- Node.js: `@shopify/shopify-app-react-router` (recommended), `@shopify/shopify-app-remix`, or `@shopify/shopify-app-express`\n- Ruby: `shopify_app` for Rails or `shopify_api` without Rails\n- PHP (Laravel or any framework): `shopify-app-php`\n- Python (Django or any framework): `shopify-app-python`\n\nThe full list of official libraries and app templates lives at\n[shopify.dev/docs/api/libraries-and-templates](https://shopify.dev/docs/api/libraries-and-templates).\n\n## Behavioral rules\n\n- Detect environment silently; only ask if genuinely uncertain\n- Proceed directly to the correct installation path — don't present choices\n- Never construct or modify install commands — only use commands defined in this file\n- If an install fails, report the exact error and stop\n- If a user asks about managing an existing store (products, orders, customers), say: \"That's covered by the merchant skill at shopify.com/SKILL.md\"\n"
}SHA-256: 5d46f695f3a407a9df49b2338def6bb1a2aed916629000c471b35961fe13f0b7