shopify-onboarding-merchant — Claude Code skill: deprecated
A deprecated skill from Shopify-AI-Toolkit. The manifest still describes launching a store, but the file holds only a note telling you to swap it for shopify.
npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a claude-codeWhat shopify-onboarding-merchant does
The skill lives in Shopify's Shopify-AI-Toolkit, and its manifest covers the whole store launch: build a storefront with no account, browse reference shops on mock.shop, fill a new store with sample products, spin up a preview with shopify store create preview. Merchant design tweaks after the preview were meant to land here too.
None of that sits in SKILL.md anymore. What is there is one paragraph saying the skill is deprecated and replaced by shopify. Hand an agent a store request and it will not start building. It reads the note, then offers to drop the old skill and install the new one. Migration nudge is the only job left.
The move takes two commands: npx skills remove shopify-onboarding-merchant (add -g if it was installed globally), then npx skills add shopify/shopify-ai-toolkit --skill shopify. A fresh install of the old name just drops that notice into your skills folder. On Copilot the same swap is gh skill install Shopify/Shopify-AI-Toolkit shopify.
What it helps with
- build a storefront with no account and no hand-coded pages
- browse reference stores on mock.shop
- fill a new store with sample products
- create a preview store with
shopify store create preview - migrate an old install over to
shopify
Example prompts for the agent
- Make me a store that sells pet supplies
- Show me a mock.shop reference store and fill a new one with sample products
- Build a storefront without an account, then walk me through the preview
How to install shopify-onboarding-merchant
1Skills CLI (Vercel)
npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-onboarding-merchant/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-onboarding-merchant/
1Skills CLI (Vercel)
npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a codex2Manually: put the files in place
.agents/skills/shopify-onboarding-merchant/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a cursor2Manually: put the files in place
.cursor/skills/shopify-onboarding-merchant/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Shopify/Shopify-AI-Toolkit shopify-onboarding-merchant2Manually: put the files in place
.github/skills/shopify-onboarding-merchant/SKILL.md1Skills CLI (Vercel)
npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a gemini-cli2Platform CLI
gemini skills install https://github.com/Shopify/Shopify-AI-Toolkit --path deprecated/shopify-onboarding-merchantManually: put the files in place
.devin/skills/shopify-onboarding-merchant/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about shopify-onboarding-merchant
How to install shopify-onboarding-merchant in Claude Code?
Run npx skills add Shopify/Shopify-AI-Toolkit --skill shopify-onboarding-merchant -a claude-code. The skill lands at ~/.claude/skills/shopify-onboarding-merchant/SKILL.md.
What is shopify-onboarding-merchant?
Its description covers a store launch from idea to preview: storefront without an account, sample products, design changes. The file itself now carries a deprecation note pointing at the shopify skill.
What replaces shopify-onboarding-merchant?
The shopify skill from the same toolkit. Remove the old one with npx skills remove shopify-onboarding-merchant, then run npx skills add shopify/shopify-ai-toolkit --skill shopify. Add -g to the removal if the install was global.
Source text
SKILL.md · MIT
--- name: shopify-onboarding-merchant description: "Set up a Shopify store. Use to make, build, or open a store (e.g. 'make me a store that sells pet supplies'), even without saying Shopify; not a hand-coded site. Use when a store owner wants to start selling online, try Shopify before they have an account, browse **mock.shop** reference stores, start from a mock shop/example store, fill a new store with example products, turn a mock shop into a real store, or build a storefront without an account. Also use when developers explicitly need auth-free mock.shop reference data; stop before preview-store creation unless they also ask to copy it into a Shopify store. Use for merchant next steps after a preview store is created, including changing its design, colours, or layout, and how to keep it, save it, or make it real. Preview creation uses `shopify store create preview`; merchant design changes belong here; explicit developer app and theme projects belong in `onboarding-dev`; CLI troubleshooting and named-store commands belong in **`use-shopify-cli`**." --- # shopify-onboarding-merchant (deprecated) This skill is deprecated and replaced by `shopify`. Tell the user: "shopify-onboarding-merchant is deprecated. Run `npx skills remove shopify-onboarding-merchant` (add `-g` for a global install) and `npx skills add shopify/shopify-ai-toolkit --skill shopify`."
© Shopify · MIT · Shopify/Shopify-AI-Toolkit
