# shopify-admin

Скилл shopify-admin пишет и объясняет Admin GraphQL запросы и мутации для приложений и интеграций Shopify. Ищет в документации, генерирует операцию и валидирует её перед возвратом.

- скилл · `type=skill` · Codex, ChatGPT, Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 8052 у репозитория
- Автор: Shopify · официальный репозиторий OpenAI
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-admin/SKILL.md
- Обновлён: 2026-10-08
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/shopify-admin

## Что делает

Скилл помогает составить GraphQL запрос или мутацию для Admin API: разработчик описывает задачу, агент ищет примеры в векторной базе (`scripts/search_docs.mjs`), пишет код и прогоняет его через `scripts/validate.mjs`. Если валидация находит ошибку (неверное имя поля, несовместимый тип), агент ищет правильное значение, правит код и проверяет снова — до трёх попыток.

Требует Node.js в окружении. Документация и примеры берутся из встроенного индекса, поиск и валидация отправляют запрос и результат на `shopify.dev/mcp/usage` (отключить можно через `OPT_OUT_INSTRUMENTATION=true`).

Для запуска готовой операции через Shopify CLI или проверки конфигурации приложения (`shopify.app.toml`) нужен другой скилл — `use-shopify-cli`.

## Установка

### Codex (родная платформа)

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

2. **Вручную: положить файлы**
- Файл: `.agents/skills/shopify-admin/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

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

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/shopify-admin/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/shopify-admin/

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/shopify-admin/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.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. **Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-admin
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/shopify-admin/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-admin/SKILL.md

## Когда брать
- написать GraphQL мутацию для создания продукта в Shopify
- найти поля и типы Admin API по названию операции
- проверить запрос перед отправкой и исправить ошибки типов
- получить ссылку на документацию для конкретной мутации
- составить запрос с вложенными объектами по примеру из базы

## Примеры запросов агенту
- Напиши мутацию для создания товара с вариантами и ценой
- Как запросить список заказов за последний месяц через Admin GraphQL
- Проверь этот запрос `productCreate` и исправь, если что-то не так

## Похожие
- [shopify-polaris-admin-extensions](https://affpapa.org/nevibecode/skills/shopify-shopify-polaris-admin-extensions.md) — скилл · 9700 установок
- [shopify](https://affpapa.org/nevibecode/skills/shopify.md) — скилл · 7700 установок
- [shopify-expert](https://affpapa.org/nevibecode/skills/shopify-expert.md) — скилл · 5400 установок
- [shopify-development](https://affpapa.org/nevibecode/skills/shopify-development.md) — скилл · 1900 установок
- [shopify-products](https://affpapa.org/nevibecode/skills/shopify-products.md) — скилл · 1400 установок
- [shopify-setup](https://affpapa.org/nevibecode/skills/shopify-setup.md) — скилл · 1300 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 567 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
