# shopify-admin

shopify-admin writes and explains Admin GraphQL queries and mutations for Shopify apps and integrations. Searches docs, generates operations, validates before returning.

- skill · `type=skill` · Codex, ChatGPT, Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 8052 repo stars
- Author: Shopify · official OpenAI repository
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-admin/SKILL.md
- Updated: 2026-10-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/shopify-admin

## What it 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`.

## Install

### Codex (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-admin -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/shopify-admin/SKILL.md` — For all projects use ~/.agents/skills/

### Claude Code

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-admin -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/shopify-admin/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/shopify-admin/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-admin -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/shopify-admin/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins plugins/shopify/skills/shopify-admin
```

2. **Manually: put the files in place**
- File: `.github/skills/shopify-admin/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-admin -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-admin
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shopify-admin/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-admin/SKILL.md

## When to use it
- 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
- 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 `productCreate` query and fix any issues

## Similar
- [shopify-polaris-admin-extensions](https://affpapa.org/en/nevibecode/skills/shopify-shopify-polaris-admin-extensions.md) — skill · 9700 installs
- [shopify](https://affpapa.org/en/nevibecode/skills/shopify.md) — skill · 7700 installs
- [shopify-expert](https://affpapa.org/en/nevibecode/skills/shopify-expert.md) — skill · 5400 installs
- [shopify-development](https://affpapa.org/en/nevibecode/skills/shopify-development.md) — skill · 1900 installs
- [shopify-products](https://affpapa.org/en/nevibecode/skills/shopify-products.md) — skill · 1400 installs
- [shopify-setup](https://affpapa.org/en/nevibecode/skills/shopify-setup.md) — skill · 1300 installs

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 567 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
