shopify-liquid — скилл для Codex: что делает и как установить
Помогает разрабатывать темы для Shopify на языке Liquid. Скилл проверяет документацию, создаёт секции со схемами и валидирует разметку через встроенный скрипт.
npx skills add openai/plugins --skill shopify-liquid -a codexЧто делает shopify-liquid
Скилл превращает агента в разработчика тем для витрин Shopify. Перед генерацией разметки Liquid агент обращается к локальной базе через scripts/search_docs.mjs, чтобы сверить свойства объектов или фильтры. Затем он пишет код секций или сниппетов с учётом структуры магазина.
После написания код в обязательном порядке проходит валидацию скриптом scripts/validate.mjs. Если тест находит ошибку, ассистент изучает причину через поиск и повторяет запуск до 3 раз. Разметка возвращается в ответ только после успешной проверки схемы.
Для исполнения скриптов требуется среда Node.js и инструмент bash. Без Node.js в системе запуск validate.mjs завершится сбоем. Инструмент учитывает ограничения языка: циклы for делятся постранично через {% paginate %} при выборке больше 50 записей, а теги {% stylesheet %} исключают выражения Liquid.
Какие задачи решает
- написать секцию с настройками
{% schema %}и блоками для редактора тем - создать переиспользуемый сниппет с документацией
{% doc %}и параметрами - настроить пагинацию каталога товаров при превышении лимита в 50 элементов
- проверить разметку Liquid через валидатор перед сохранением в проект
Примеры запросов агенту
- Собери секцию отзывов с поддержкой блоков для редактора тем и схемой настроек.
- Напиши сниппет карточки товара с параметром цены и блоком
{% doc %}. - Сделай форму подписки на рассылку с выводом ошибок через фильтр
default_errors.
Как установить shopify-liquid
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-liquid -a codex2Вручную: положить файлы
.agents/skills/shopify-liquid/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-liquid -a claude-code2Вручную: положить файлы
~/.claude/skills/shopify-liquid/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/shopify-liquid/
Вручную: положить файлы
.cursor/skills/shopify-liquid/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-liquid2Вручную: положить файлы
.github/skills/shopify-liquid/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-liquidВручную: положить файлы
.devin/skills/shopify-liquid/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о shopify-liquid
Как установить shopify-liquid в Codex?
Для установки выполните команду npx skills add openai/plugins --skill shopify-liquid -a codex. Также можно вручную поместить файл конфигурации по пути .agents/skills/shopify-liquid/SKILL.md.
Что делает скилл shopify-liquid?
Он создаёт секции и сниппеты для тем Shopify по правилам архитектуры Liquid. Перед выдачей ответа скилл ищет документацию и запускает локальную проверку кода.
Что нужно для работы скилла?
Требуется установленный Node.js и поддержка вызова консоли через bash. Без Node.js агент не сможет выполнить валидацию через scripts/validate.mjs.
