shopify-partner — Codex skill: what it does, how to install
Generates and validates Shopify Partner API GraphQL operations for apps and theme management. Requires Node.js.
npx skills add openai/plugins --skill shopify-partner -a codexWhat shopify-partner does
This skill configures the model to craft GraphQL queries and mutations for the Partner Dashboard. It covers partner payouts and theme records. Note that this API expects partner-level credentials instead of merchant store tokens.
The workflow enforces two bash steps for every generation. First, scripts/search_docs.mjs retrieves relevant types from documentation. Next, scripts/validate.mjs checks the output. If validation fails, the assistant inspects the error and retries up to 3 times.
Node.js must be installed on your machine. Both helper scripts send usage telemetry to shopify.dev/mcp/usage. You can disable this tracking by setting OPT_OUT_INSTRUMENTATION=true.
What it helps with
- Write GraphQL queries for Partner Dashboard app metrics
- Verify schema compatibility with the built-in validator script
- Filter partner payouts and transaction records by date
- Retrieve referral commission tracking metrics
Example prompts for the agent
- Generate a Partner API GraphQL query for app installation data
- Create a mutation to publish a theme version in the partner account
- Query partner payout records for the previous month
How to install shopify-partner
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-partner -a codex2Manually: put the files in place
.agents/skills/shopify-partner/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-partner -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-partner/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-partner/
Manually: put the files in place
.cursor/skills/shopify-partner/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-partner2Manually: put the files in place
.github/skills/shopify-partner/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-partnerManually: put the files in place
.devin/skills/shopify-partner/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-partner
How do I install shopify-partner in Codex?
Run npx skills add openai/plugins --skill shopify-partner -a codex. The skill definition is placed in .agents/skills/shopify-partner/SKILL.md.
What does the shopify-partner skill do?
It looks up Partner API documentation and validates GraphQL operations via bash before returning code.
How can I opt out of telemetry?
Set OPT_OUT_INSTRUMENTATION=true in your environment variables.