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. NOT for merchants managing stores.
SKILL.md
Flow
Step 1 — Detect environment
Silently identify the client from system context:
| Signal | Client |
|---|---|
| "Claude Code" | claude-code |
| "Cursor" | cursor |
| "VSCode" / "Visual Studio Code" | vscode |
| "Gemini CLI" | gemini-cli |
| Unrecognized | other |
If genuinely uncertain about client, ask. Never guess.
Step 2 — Install prerequisites
Check if Shopify CLI is installed by running shopify version.
If the CLI is present and the AI toolkit plugin is already available,
skip to Step 3.
Shopify CLI — if not found, install using your package manager (npm, pnpm, yarn, and bun all work):
npm install -g @shopify/cli@latest
If no Node package manager is available, use Homebrew (macOS only):
brew tap shopify/shopify && brew install shopify-cli
Verify with shopify version before continuing.
AI toolkit plugin/extension — install for the detected client:
| Client | Install command |
|---|---|
claude-code | /plugin marketplace add Shopify/shopify-ai-toolkit then /plugin install shopify-plugin@shopify-ai-toolkit |
cursor | /add-plugin and search for "Shopify", or visit cursor.com/marketplace/shopify |
vscode | Command Palette (Cmd+Shift+P) → Chat: Install Plugin From Source → paste https://github.com/Shopify/Shopify-AI-Toolkit |
gemini-cli | gemini extensions install https://github.com/Shopify/shopify-ai-toolkit (run in terminal, not inside CLI) |
other | Not supported — inform the user and stop |
If install fails, report the exact error and stop.
Step 3 — Post-install
Confirm what was installed in one sentence. If the developer hasn't mentioned a specific goal yet, ask:
"What would you like to build?
- An app for Shopify
- A theme for Shopify
Or if you need a developer account first, create one free at dev.shopify.com/dashboard."
From here, let the developer's request flow to the appropriate
API-specific skill (e.g. shopify-admin, shopify-liquid,
shopify-functions). Do not duplicate their routing logic.
Behavioral rules
- Detect environment silently; only ask if genuinely uncertain
- Proceed directly to the correct installation path — don't present choices
- Never construct or modify install commands — only use commands defined in this file
- If an install fails, report the exact error and stop
- 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"
More skills from the plugins repository
View all 600 skillsaccessibility-and-inclusive-visualization
make data visualizations accessible
Jun 30AccessibilityChartsData VisualizationDesignagent-browser
automate browser interactions for agents
Apr 6AgentsBrowser AutomationTestingagent-browser-verify
verify dev server output with automated browser
Apr 6Browser AutomationLocal DevelopmentTestingagents-sdk
build AI agents on Cloudflare Workers
Apr 6AgentsCloudflare WorkersSDKServerless +1ai-elements
build chat UIs with AI Elements
Apr 6FrontendReactshadcn/uiUI Components +1ai-gateway
configure Vercel AI Gateway
Apr 6AI InfrastructureCost OptimizationLLMPerformance +1
More from OpenAI
View publisherprior-auth-packet-builder
build healthcare prior authorization packets
openai-agents-python
Apr 16DocumentsHealthcareInsuranceRegulatory Complianceaspnet-core
build ASP.NET Core web applications
skills
Apr 12.NETASP.NET CoreBlazorC# +1chatgpt-apps
build ChatGPT Apps SDK applications
skills
Apr 12Apps SDKChatGPTMCPOpenAIcli-creator
build CLIs from API docs
skills
Apr 12API DevelopmentCLICodexcloudflare-deploy
deploy projects to Cloudflare
skills
Apr 12CloudflareCloudflare PagesCloudflare WorkersDeploymentdefine-goal
define and set measurable project goals
skills
May 23ProductivityProject ManagementStrategyTask Management