plugins/shopify/skills/shopify-onboarding-dev/SKILL.md
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.
npx skillsauth add openai/plugins shopify-onboarding-devInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
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.
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.
development
Use when the user wants to spin up / create / launch / provision a DigitalOcean droplet (or "a remote dev box on DO") and connect to it from Codex as a remote SSH workspace.
data-ai
Search through Microsoft Teams chats or channels, triage unread or recent activity, draft follow-ups, and manage Planner tasks through connected Teams data.
tools
Motion / animation context for the `use_figma` MCP tool — animating Figma nodes via manual keyframes, animation styles, easing, and timeline duration. Load alongside figma-use whenever a task involves adding, editing, or inspecting animation on a node.
development
SwiftUI ↔ Figma translation. Use whenever the user mentions Swift, SwiftUI, iOS, iPhone, or iPad — in EITHER direction — translating a Figma design into SwiftUI (design → code), or pushing SwiftUI views / screens / tokens back into a Figma file (code → design). Triggers on phrases like 'implement this Figma design in SwiftUI', 'build this screen in Swift', 'push this SwiftUI view to Figma', 'mirror my Swift code in a Figma file', or whenever a Figma URL appears alongside `.swift` files / an `.xcodeproj`. Routes to a direction-specific reference doc; loads alongside `figma-use` for the code → design path.