shopify-customer — Codex skill for Shopify GraphQL accounts
Helps build GraphQL queries and mutations for Shopify’s Customer Account API. Use it when working with a customer’s orders, addresses, or account data.
npx skills add openai/plugins --skill shopify-customer -a codexWhat shopify-customer does
This skill guides Shopify developers through finding relevant API documentation, drafting a GraphQL operation, and checking the result. Customer Account API works in an authenticated customer’s context and exposes that customer’s own data. It serves a different purpose from Admin API, which handles store management.
The skill uses scripts/search_docs.mjs to look up documentation and scripts/validate.mjs to check generated code. Node.js is required. Both scripts send usage details to Shopify; validation can also transmit the code being checked and related context. Set OPT_OUT_INSTRUMENTATION=true beforehand to disable that reporting.
Documentation search comes before code generation, and validation is required before returning code. If the scripts cannot run, those steps cannot be completed.
What it helps with
- build a GraphQL query for a customer’s order history
- draft a mutation to update an account address
- find Customer Account API operations for payment methods
- check a GraphQL operation before returning it
Example prompts for the agent
- Write a Customer Account API query for the authenticated customer’s orders.
- Draft a mutation to add an address to the customer’s account.
- Find an operation for updating a customer profile, then validate the GraphQL code.
How to install shopify-customer
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-customer -a codex2Manually: put the files in place
.agents/skills/shopify-customer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-customer -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-customer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-customer/
Manually: put the files in place
.cursor/skills/shopify-customer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-customer2Manually: put the files in place
.github/skills/shopify-customer/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-customerManually: put the files in place
.devin/skills/shopify-customer/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-customer
How do I install shopify-customer in Codex?
Run npx skills add openai/plugins --skill shopify-customer -a codex. The skill file is at .agents/skills/shopify-customer/SKILL.md.
What does shopify-customer do?
It looks up Shopify Customer Account API documentation and helps draft and validate GraphQL queries and mutations for customer account data.
What does shopify-customer need to run?
Node.js is required. The skill uses scripts/search_docs.mjs and scripts/validate.mjs; their usage reports go to Shopify unless OPT_OUT_INSTRUMENTATION=true is set.