# shopify-storefront-graphql

Writes GraphQL queries and mutations against the Shopify Storefront API, searching the docs first and validating the code before it reaches you.

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

## What it does

The skill walks the agent through three steps. First `scripts/search_docs.mjs "<query>"` looks up the operation or resource in a vector store of the developer docs, then the code is written from what came back, and `scripts/validate.mjs` runs before anything is returned, with `--model`, `--client-name`, `--client-version`, `--artifact-id` and `--revision` flags. When validation fails, the agent searches for the type or value named in the error, fixes it and validates again, up to 3 retries.

Both scripts report to Shopify: the search query, the validation result, the skill name and version, model and client identifiers, and the code being checked. Set `OPT_OUT_INSTRUMENTATION=true` in your environment to opt out. Node.js is required.

This one is for a custom storefront where you render your own UI and fetch data over GraphQL. If the task mentions tags like `<shopify-store>`, `<shopify-cart>`, reach for `storefront-web-components` instead. Author is Shopify, version 1.9.1.

## Install

### Codex (native platform)

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

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

### Claude Code

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

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

### Cursor

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

### GitHub Copilot

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

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

### Gemini CLI

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

### Windsurf (Devin Desktop)

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

## When to use it
- write a Storefront API query from an operation name
- build a cart and checkout mutation
- validate GraphQL code before it lands in the project
- look up current fields and types instead of guessing
- fix a validation error by the type or value it names

## Example prompts
- Write a Storefront API query for product variants
- Create a cart mutation and add a line item
- Validate this GraphQL query before returning it

## Similar
- [storefront-builder](https://affpapa.org/en/nevibecode/skills/storefront-builder.md) — skill · 384 installs
- [storefront-best-practices](https://affpapa.org/en/nevibecode/skills/storefront-best-practices.md) — skill · 4600 installs
- [shopify-setup](https://affpapa.org/en/nevibecode/skills/shopify-setup.md) — skill · 1200 installs
- [shopify-expert](https://affpapa.org/en/nevibecode/skills/shopify-expert.md) — skill · 5000 installs
- [shopify](https://affpapa.org/en/nevibecode/skills/shopify.md) — skill · 4800 installs
- [shopify-development](https://affpapa.org/en/nevibecode/skills/shopify-development.md) — skill · 1900 installs

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