← ShopifyCONTENT HISTORY

Update to Shopify

Snapshot Sep 30, 2026 · 22:43 UTC · version 4.1.1

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full 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