# shopify-partner

Generates and validates Shopify Partner API GraphQL operations for apps and theme management. Requires Node.js.

- skill · `type=skill` · Codex, ChatGPT · ★ 7604
- 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-partner/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/shopify-partner

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

## Install

### Codex (native platform)

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

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

### Claude Code

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

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

### Cursor

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

### GitHub Copilot

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

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

### Gemini CLI

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shopify-partner/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-partner/SKILL.md

## When to use it
- 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
- 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

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 528 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