shopify-custom-data — скилл для Codex: метаполя и метаобъекты Shopify
Скилл для Codex и ChatGPT, который ведёт агента по работе с Metafields и Metaobjects в приложениях Shopify.
npx skills add openai/plugins --skill shopify-custom-data -a codexЧто делает shopify-custom-data
Скилл включается, когда в промпте появляются слова Metafields или Metaobjects, и задаёт порядок работы: сначала определения, потом запись значений, потом чтение. Определения описываются в shopify.app.toml — версионируются вместе с кодом и ставятся автоматически. Для чтения и записи значений дальше идёт GraphQL Admin или Storefront API.
Внутри прописаны конкретные вызовы: запись метаполей через metafieldsSet, запись метаобъектов через metaobjectUpsert, чтение через jsonValue с алиасами. Отдельно разобраны доступ к метаполям в checkout-расширениях через useAppMetafields и выборка в Shopify Functions. Скилл настаивает на одном подходе и не предлагает альтернатив, если их не попросили — это снижает путаницу у разработчика.
Есть подводный камень с неймспейсами. Метаобъекты из [metaobjects.app.example] читаются как $app:example, а не app. Автор называет вариант namespace: app грубой ошибкой, так что проверьте свои запросы. Для работы нужен Node.js. Скаффолдить приложения и расширения скилл советует только через Shopify CLI: shopify app init, shopify app generate extension, shopify app dev, shopify app deploy.
Какие задачи решает
- описать схему метаполей товара в
shopify.app.toml - записать значение метаполя через
metafieldsSet - создать метаобъект-автора и связать его с товаром
- прочитать метаполе в checkout-расширении без сетевого запроса
- выбрать метаполя в GraphQL-запросе Shopify Functions
Примеры запросов агенту
- Добавь метаполе care_guide для товара через shopify.app.toml
- Запиши значение метаполя example для товара gid://shopify/Product/1234
- Покажи, как прочитать метаобъект типа $app:author в Storefront API
Как установить shopify-custom-data
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-custom-data -a codex2Вручную: положить файлы
.agents/skills/shopify-custom-data/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-custom-data -a claude-code2Вручную: положить файлы
~/.claude/skills/shopify-custom-data/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shopify-custom-data/
Вручную: положить файлы
.cursor/skills/shopify-custom-data/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-custom-data2Вручную: положить файлы
.github/skills/shopify-custom-data/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-custom-dataВручную: положить файлы
.devin/skills/shopify-custom-data/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Из того же набора300
Весь набор →Похожие
Рядом в теме «Бэкенд и API»
Всё по теме «Бэкенд и API» →Вопросы о shopify-custom-data
Как установить shopify-custom-data в Claude?
Выполните npx skills add openai/plugins --skill shopify-custom-data, затем npx skills add openai/plugins --skill shopify-custom-data -a codex. Файл скилла окажется в .agents/skills/shopify-custom-data/SKILL.md.
Что делает shopify-custom-data?
Задаёт агенту порядок работы с Metafields и Metaobjects: определения в TOML, запись значений через Admin API, чтение через Admin или Storefront API.
Нужен ли Node.js для этого скилла?
Да, в требованиях указан Node.js. Скилл также настаивает на работе через Shopify CLI для создания приложений и расширений.
