shopify-polaris-admin-extensions · openai — скилл для Codex
Помогает писать код расширений для админки Shopify на Polaris: агент ищет в документации, генерирует код и проверяет его валидатором.
npx skills add openai/plugins --skill shopify-polaris-admin-extensions -a codexЧто делает shopify-polaris-admin-extensions
Скилл ведёт агента по работе с Admin UI Extensions из приложения Shopify. Он ищет нужные операции в документации через scripts/search_docs.mjs, пишет код на Web Components Polaris и затем прогоняет его через scripts/validate.mjs с обязательными флагами: --model, --client-name, --client-version, --artifact-id, --revision и --target. Без --target валидация не пройдёт, поэтому цель расширения вроде admin.product-details.block.render указывать нужно всегда.
Для каждого типа расширения в скилле прописана своя команда генерации через Shopify CLI: admin_action, admin_block, admin_link, admin_print. Ручную сборку шаблона скилл прямо запрещает — CLI выдаёт заготовку под актуальную версию API.
Валидатор считает HTML-комментарии в коде ошибкой, так что <!-- ... --> из вывода агента надо убирать. Ещё одно требование: Node.js, иначе скрипты не запустятся. Установка сводится к одной команде npx skills add с флагом -a codex, файл скилла ляжет в .agents/skills/shopify-polaris-admin-extensions/SKILL.md.
Какие задачи решает
- сгенерировать заготовку админ-действия через Shopify CLI
- написать блок для карточки товара на Web Components Polaris
- проверить код расширения валидатором до отдачи заказчику
- разобраться, какой API доступен для конкретного типа расширения
- сделать печатное действие для документов из заказа
Примеры запросов агенту
- Сгенерируй админ-блок для страницы товара и проверь его валидатором с
--target admin.product-details.block.render - Поищи в документации, как вывести пикер ресурсов в admin-действии, и напиши код
- Сделай печатное действие для инвойса и прогони
scripts/validate.mjsперед ответом
Как установить shopify-polaris-admin-extensions
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-polaris-admin-extensions -a codex2Вручную: положить файлы
.agents/skills/shopify-polaris-admin-extensions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-polaris-admin-extensions -a claude-code2Вручную: положить файлы
~/.claude/skills/shopify-polaris-admin-extensions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shopify-polaris-admin-extensions/
Вручную: положить файлы
.cursor/skills/shopify-polaris-admin-extensions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-polaris-admin-extensions2Вручную: положить файлы
.github/skills/shopify-polaris-admin-extensions/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-polaris-admin-extensionsВручную: положить файлы
.devin/skills/shopify-polaris-admin-extensions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о shopify-polaris-admin-extensions
Как установить shopify-polaris-admin-extensions в Claude?
Выполните npx skills add openai/plugins --skill shopify-polaris-admin-extensions -a codex. Файл скилла появится по пути .agents/skills/shopify-polaris-admin-extensions/SKILL.md.
Что делает shopify-polaris-admin-extensions?
Учит агента писать расширения для админки Shopify: сначала поиск в документации, потом генерация кода и проверка валидатором. В ответ код попадает только после успешной валидации.
Что нужно для работы скилла?
Node.js — на нём держатся скрипты поиска и валидации. Расширения при этом создаются через Shopify CLI, чтобы шаблон соответствовал актуальной версии API.
Похожие скиллы
Все скиллы по теме «Фронтенд и UI» →Сначала — shopify-polaris-admin-extensions от других авторов.
