Паттерны композиции в React

Делает компоненты React составными: вместо булевых пропсов — общий контекст, состояние в провайдере и явные варианты, плюс изменения React 19. Для случаев, когда у компонента слишком много флагов или собирается библиотека компонентов.

РазработкаПак: Скиллы Vercelссылкаcomposition-patterns
Автор
Источник
vercel-labs/agent-skills/skills/composition-patterns @ 1a2c79d
Лицензия
MIT

Об этом скилле

Что делает

Скилл нацелен на одну частую беду React-кода: компонент обрастает булевым пропсом на каждый случай, и скоро никто не знает, какие сочетания работают. Восемь правил заменяют настройку пропсами композицией.

Выше всего стоит архитектура компонентов: не менять поведение булевыми пропсами, а сложные компоненты строить как составные, с общим контекстом. Управление состоянием: как хранится состояние, знает только провайдер; контекст отдаёт общий интерфейс из state, actions и meta, чтобы один и тот же UI работал поверх разных реализаций состояния; состояние поднимается в провайдер, чтобы до него дотянулись соседи. Два приёма реализации: явные компоненты-варианты вместо режимов (пример из README — ThreadComposer и EditComposer вместо Composer с isThread) и children вместо пропсов вида renderX. Последний раздел — только для React 19, на React 18 его пропускают: ref как обычный пропс вместо forwardRef и use() вместо useContext().

SKILL.md — оглавление. У каждого правила свой файл в rules/ с объяснением и парой примеров «неправильно — правильно»; AGENTS.md (около 22 КБ) собирает их вместе.

Когда включать и когда не надо

Когда у компонента накопились флаги вроде isEditing или showActions, когда собираете библиотеку компонентов или дизайн-систему и на ревью архитектуры.

О стилях, доступности и скорости здесь ни слова. Компоненту с одним-двумя пропсами составные части и провайдер не нужны: правила окупаются, когда появляются настоящие варианты.

Как поставить и вызвать

Этот скилл мы не копируем: во frontmatter указана MIT, но в репозитории нет текста лицензии, который положено приложить к копии. Ставьте его из репозитория Vercel по кнопке к исходнику; README там предлагает установщик skills.sh, npx skills add vercel-labs/agent-skills, а флаг --skill vercel-composition-patterns ограничит установку этим скиллом. В name у него стоит vercel-composition-patterns:

  • Claude Code: /vercel-composition-patterns или попросить скилл по имени.
  • Codex: $vercel-composition-patterns.
  • Cursor: наберите / в чате Agent и выберите vercel-composition-patterns.

Пример: /vercel-composition-patterns У нашего Modal девять булевых пропсов. Предложи API на составных компонентах и переведи на него три места вызова.

Чем отличается от похожих

Фронтенд-интерфейсы для продакшена формулирует тот же принцип одной строкой среди правил о состоянии, дизайне и доступности; этот скилл разбирает его на коде. Проектирование глубоких модулей — об интерфейсах модулей на любом языке, а не о React. Проектирование API и интерфейсов видит в пропсах один контракт из многих. Лучшие практики React Native применяет составные компоненты к кнопкам дизайн-системы.

Установка

Скилл не скопирован в каталог: в репозитории автора нет текста лицензии. Установите его оттуда.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Открыть источник

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Vercel

Правила производительности React и Next.js

Делает ревью и правки кода на React и Next.js по 70 правилам производительности от Vercel: водопады запросов, размер бандла, сервер, ре-рендеры. Для случаев, когда пишете или переделываете компоненты и загрузку данных.

Лучшие практики React Native

Делает мобильный код на React Native и Expo быстрее по правилам Vercel: виртуализация списков, анимации transform и opacity, нативная навигация, expo-image, монорепозиторий. Для случаев, когда приложение тормозит или идёт ревью.

Анимации переходов в React

Делает анимации переходов на View Transition API в React: перетекание общих элементов, появление после Suspense, перестановку списков, сдвиги между страницами. Для случаев, когда в приложение на Next.js или React 19.3+ нужны переходы.

Деплой на Vercel от Vercel Labs

Делает деплой проекта на Vercel в превью: по состоянию проекта выбирает git push, деплой из CLI, привязку или временный деплой без аккаунта и возвращает ссылку. Для случаев, когда нужно выложить приложение и получить ссылку.

Vercel CLI с токенами

Делает деплой и управление проектом Vercel по токену доступа без входа через браузер: ищет токен, выкладывает превью, ведёт переменные окружения, логи и домены. Для случаев, когда агент работает в неинтерактивной среде.

Оптимизация затрат и скорости на Vercel

Делает аудит затрат и скорости проекта на Vercel: сначала метрики, затем отбор кандидатов по порогам, разбор только отмеченных маршрутов и проверенные рекомендации со ссылками. Для случаев, когда нужно урезать счёт или ускорить маршруты.

Ревью по Web Interface Guidelines

Делает ревью кода интерфейса по Web Interface Guidelines от Vercel, которые скачивает при каждом запуске, и выдаёт находки в виде file:line. Для случаев, когда нужно быстро проверить компоненты или страницы перед пулреквестом.

Ревью текстов по Writing Guidelines

Делает ревью документации и текстов по справочнику стиля Vercel, который скачивает при каждом запуске, и выдаёт находки в виде file:line. Для случаев, когда англоязычную документацию нужно проверить перед публикацией.