# shopify-liquid

Помогает разрабатывать темы для Shopify на языке Liquid. Скилл проверяет документацию, создаёт секции со схемами и валидирует разметку через встроенный скрипт.

- скилл · `type=skill` · Codex, ChatGPT · ★ 7604
- Автор: Shopify · официальный репозиторий OpenAI
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-liquid/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/shopify-liquid

## Что делает

Скилл превращает агента в разработчика тем для витрин Shopify. Перед генерацией разметки Liquid агент обращается к локальной базе через `scripts/search_docs.mjs`, чтобы сверить свойства объектов или фильтры. Затем он пишет код секций или сниппетов с учётом структуры магазина.

После написания код в обязательном порядке проходит валидацию скриптом `scripts/validate.mjs`. Если тест находит ошибку, ассистент изучает причину через поиск и повторяет запуск до 3 раз. Разметка возвращается в ответ только после успешной проверки схемы.

Для исполнения скриптов требуется среда Node.js и инструмент `bash`. Без Node.js в системе запуск `validate.mjs` завершится сбоем. Инструмент учитывает ограничения языка: циклы `for` делятся постранично через `{% paginate %}` при выборке больше 50 записей, а теги `{% stylesheet %}` исключают выражения Liquid.

## Установка

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

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

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

### Claude Code

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

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

### Cursor

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

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.github/skills/shopify-liquid/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-liquid
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- написать секцию с настройками `{% schema %}` и блоками для редактора тем
- создать переиспользуемый сниппет с документацией `{% doc %}` и параметрами
- настроить пагинацию каталога товаров при превышении лимита в 50 элементов
- проверить разметку Liquid через валидатор перед сохранением в проект

## Примеры запросов агенту
- Собери секцию отзывов с поддержкой блоков для редактора тем и схемой настроек.
- Напиши сниппет карточки товара с параметром цены и блоком `{% doc %}`.
- Сделай форму подписки на рассылку с выводом ошибок через фильтр `default_errors`.

## Похожие
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок
- [prototype](https://affpapa.org/nevibecode/skills/prototype.md) — скилл · 986201 установка
- [hyperframes](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes.md) — скилл · 1200000 установок
- [hyperframes-cli](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes-cli.md) — скилл · 1300000 установок
- [webapp-testing](https://affpapa.org/nevibecode/skills/webapp-testing.md) — скилл · 186758 установок

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

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