shopify-admin — Codex skill: what it does, how to install
shopify-admin writes and explains Admin GraphQL queries and mutations for Shopify apps and integrations. Searches docs, generates operations, validates before returning.
no license 1 installs ★ 8,052 updated 2026-10-08
npx skills add openai/plugins --skill shopify-admin -a codexWhat shopify-admin does
The skill helps you write Admin API GraphQL queries and mutations: you describe the task, the agent searches the vector store with scripts/search_docs.mjs, writes the code, and runs scripts/validate.mjs. When validation catches an error (wrong field name, incompatible type), the agent searches for the correct value, fixes the code, and validates again — up to three attempts.
Requires Node.js in the environment. Documentation and examples come from the built-in index; search and validation send the query and result to shopify.dev/mcp/usage (disable via OPT_OUT_INSTRUMENTATION=true).
To run the finished operation via Shopify CLI or validate app config (shopify.app.toml), you need a different skill — use-shopify-cli.
What it helps with
- write a GraphQL mutation to create a product in Shopify
- find Admin API fields and types by operation name
- validate a query before sending and fix type errors
- get a documentation link for a specific mutation
- build a query with nested objects from a docs example
Example prompts for the agent
- Write a mutation to create a product with variants and pricing
- How do I query orders from the last month via Admin GraphQL
- Check this
productCreatequery and fix any issues
How to install shopify-admin
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-admin -a codex2Manually: put the files in place
.agents/skills/shopify-admin/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-admin -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-admin/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-admin/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-admin -a cursor2Manually: put the files in place
.cursor/skills/shopify-admin/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins plugins/shopify/skills/shopify-admin2Manually: put the files in place
.github/skills/shopify-admin/SKILL.md1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-admin -a gemini-cli2Platform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-adminManually: put the files in place
.devin/skills/shopify-admin/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-admin
How to install shopify-admin in Codex?
Run npx skills add openai/plugins --skill shopify-admin or npx skills add openai/plugins --skill shopify-admin -a codex. The skill will appear in .agents/skills/shopify-admin/SKILL.md.
What does shopify-admin do?
Writes and explains Admin GraphQL queries and mutations for Shopify apps. Searches docs for examples, generates the operation, validates the code, and fixes type errors before returning.
How is shopify-admin different from use-shopify-cli?
shopify-admin writes the GraphQL operation itself. use-shopify-cli runs it through Shopify CLI, sets up store auth, and validates app config.