shopify-onboarding-merchant · openai — Codex skill: Shopify setup
This skill walks a merchant through Shopify CLI setup, store creation, and connection of an existing store from an AI assistant.
npx skills add openai/plugins --skill shopify-onboarding-merchant -a codexWhat shopify-onboarding-merchant does
The skill guides a store owner through Shopify CLI installation and the first connection step. It checks shopify version, then offers npm installation or the Homebrew route on macOS. After setup, it asks whether to create a new store or link an existing one.
For a new store, the flow opens Shopify’s trial signup page. An existing store is identified through https://admin.shopify.com/store/{handle} or {handle}.myshopify.com. The skill normalizes the handle and runs shopify store auth, which opens a browser session and waits for the merchant to approve the permissions.
Node.js is needed when neither npm nor Homebrew is available. The authentication flow needs Shopify CLI 3.93.0 or newer, so older CLI installations need an upgrade first.
What it helps with
- install Shopify CLI
- create a new Shopify store
- connect an existing store by URL
- complete browser-based store authorization
- normalize a store address to
.myshopify.com
Example prompts for the agent
- Install Shopify CLI and help me create a new store.
- Connect my existing store at
your-handle.myshopify.com. - Check Shopify CLI, then authorize
https://admin.shopify.com/store/{handle}.
How to install shopify-onboarding-merchant
1Skills CLI (Vercel)
npx skills add openai/plugins --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 openai/plugins --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/
Manually: put the files in place
.cursor/skills/shopify-onboarding-merchant/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-onboarding-merchant2Manually: put the files in place
.github/skills/shopify-onboarding-merchant/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-onboarding-merchantManually: put the files in place
.devin/skills/shopify-onboarding-merchant/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about shopify-onboarding-merchant
How do I install shopify-onboarding-merchant in Codex?
Run npx skills add openai/plugins --skill shopify-onboarding-merchant. The skill file is placed at .agents/skills/shopify-onboarding-merchant/SKILL.md.
What does shopify-onboarding-merchant do?
It guides a merchant through Shopify CLI installation, new-store creation, or connection of an existing store. Store authorization runs through a browser session started by Shopify CLI.
What is required to connect a Shopify store?
Provide a store URL in the form https://admin.shopify.com/store/{handle} or {handle}.myshopify.com. The merchant must approve the permissions in the browser window.
Similar skills
All skills for Agent setup: memory, context, orchestration →shopify-onboarding-merchant by other authors comes first.