К основному содержанию
скилл CX Codex

tailwind-v4 · mastra-ai — скилл для Claude Code: что делает и как установить

Скилл tailwind-v4 для Tailwind CSS v4: показывает агенту CSS-first конфигурацию и ловит классы v3, которые компилируются, но в новом коде не нужны.

Apache-2.0 120 установок ★ 29 724 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mastra-ai/mastra --skill tailwind-v4 -a claude-code
Открыть на GitHub

Что делает tailwind-v4

Скилл держит агента в рамках идиом Tailwind CSS v4. Конфигурация живёт в CSS: токены лежат в @theme, свои утилиты пишутся через @utility. Файл tailwind.config.ts для новой работы не нужен.

Главное в скилле — таблица переименований. Имена сместились на ступень вниз: shadow-sm стал shadow-xs, а shadow стал shadow-sm. Ошибки не будет, v3-написание просто рисуется меньше. То же касается rounded и blur. Есть и другие замены: outline-none → outline-hidden, bg-gradient-to-r → bg-linear-to-r, !bg-red-500 → bg-red-500!. Произвольные значения скилл меняет на именованные: вместо h-[1.5rem] w-[1.5rem] пишется size-6.

Сборные классы вроде bg-${tone}-500 запрещены, потому что Tailwind должен видеть в исходниках полные строки. Скилл написан под репозиторий Mastra и отсылает к package.json пакетов playground за закреплённой версией tailwindcss (на момент написания 4.3.3). В своём проекте сверяйтесь с той версией, что стоит у вас.

Какие задачи решает

  • перенести настройки из tailwind.config.ts в @theme и @import 'tailwindcss'
  • найти v3-классы вроде shadow-sm и rounded, которые в v4 рисуются мельче
  • заменить h-[1.5rem] w-[1.5rem] на size-6
  • починить динамические классы, которые Tailwind не видит в исходниках
  • завести вариант dark через @custom-variant вместо JS-плагина

Примеры запросов агенту

  • Пройдись по классам этого компонента и перепиши всё, что осталось от Tailwind v3.
  • Используй скилл tailwind-v4: добавь цветовой токен через @theme и скажи, какие утилиты он создаст.
  • Убери произвольные значения в квадратных скобках там, где в Tailwind v4 есть готовая утилита.

Как установить tailwind-v4

1Через Skills CLI (Vercel)

npx skills add mastra-ai/mastra --skill tailwind-v4 -a claude-code

2Вручную: положить файлы

~/.claude/skills/tailwind-v4/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tailwind-v4/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tailwind-v4

Как установить tailwind-v4 в Claude Code?

Выполните npx skills add mastra-ai/mastra --skill tailwind-v4 -a claude-code. Файл скилла окажется в ~/.claude/skills/tailwind-v4/SKILL.md.

Что делает tailwind-v4?

Подсказывает агенту, как писать Tailwind CSS v4 и какой синтаксис v3 заменить. Срабатывает на задачи с классами Tailwind, блоками @theme, CSS-first конфигурацией и чисткой старого синтаксиса.

Почему shadow-sm из v3 в v4 выглядит иначе?

В v4 имена сместились на ступень: shadow-sm стал shadow-xs, а shadow стал shadow-sm. Старое написание компилируется, но тень получается меньше, поэтому скилл заменяет его.

Исходный текст

SKILL.md · Apache-2.0
---
name: tailwind-v4
description: Tailwind CSS v4 usage guide and v3-to-v4 differences. This skill should be used when writing, reviewing, or refactoring any Tailwind CSS code in this repo. Triggers on tasks involving Tailwind classes, @theme blocks, CSS-first configuration, or cleanup of v3-era syntax.
---

# Tailwind CSS v4

How to write idiomatic Tailwind v4 and spot v3-era syntax that still compiles but should not appear in new code.

## Version and sources

Check the pinned version before using recent utilities: the playground packages pin `tailwindcss` in their `package.json` (4.3.3 at the time of writing, including v4.3 utilities like `scrollbar-*`, `zoom-*`, and `tab-*`). When unsure whether a utility, variant, or directive exists in the pinned version, verify against the docs instead of guessing:

- Utility/variant reference: https://tailwindcss.com/docs
- v3 → v4 migration: https://tailwindcss.com/docs/upgrade-guide
- What each minor added: https://tailwindcss.com/blog/tailwindcss-v4 (and `/tailwindcss-v4-1`, `/tailwindcss-v4-3`, ...)

## CSS-first configuration

Tailwind v4 is configured in CSS, not JavaScript.

| Use                                                                        | Never use (v3-era)                    |
| -------------------------------------------------------------------------- | ------------------------------------- |
| `@import 'tailwindcss'`                                                    | `@tailwind base/components/utilities` |
| `@theme { --color-x: ...; }` for tokens that should generate utilities     | `tailwind.config.ts` for new work     |
| `@utility name { ... }` for custom utilities (works with variants)         | `@layer utilities { .name { ... } }`  |
| `@custom-variant dark (&:is(.dark *))`                                     | JS `plugins` / `addVariant`           |
| `@source "path"` / `@source inline("...")` for extra sources / safelisting | `content` array / `safelist` config   |
| `@variant dark { ... }` to apply a Tailwind variant inside custom CSS      | duplicating media queries / selectors |
| `@reference "app.css"` for `@apply` in scoped styles (Vue, CSS Modules)    | duplicating stylesheet imports        |
| `var(--color-x)` in CSS, `getComputedStyle` in JS                          | `theme()` function, `resolveConfig`   |
| `@config "…"` / `@plugin "…"` only for existing JS-config integrations     | adding new JS configs or plugins      |

`@theme` variables are API: each one emits a native CSS variable AND generates utilities (`--color-*` → `bg-*`/`text-*`/`border-*`/..., `--text-*` → `text-*`, `--shadow-*` → `shadow-*`, `--animate-*` → `animate-*`, `--breakpoint-*` → responsive variants). A plain `:root { --x: ...; }` variable generates nothing — use it for runtime-only values. When a token's value references another variable (`--color-x: var(--y)`), declare it in `@theme inline` so the utility resolves the reference at the declaration site. In custom CSS, `--alpha(var(--color-x) / 50%)` and `--spacing(4)` replace v3 `theme()` math.

## v3 → v4 renames

Bare names shifted one step down the scale, so the v3 spelling silently renders smaller or lighter:

| v3                                | v4                                                                |
| --------------------------------- | ----------------------------------------------------------------- |
| `shadow-sm` / `shadow`            | `shadow-xs` / `shadow-sm`                                         |
| `drop-shadow-sm` / `drop-shadow`  | `drop-shadow-xs` / `drop-shadow-sm`                               |
| `blur-sm` / `blur`                | `blur-xs` / `blur-sm`                                             |
| `rounded-sm` / `rounded`          | `rounded-xs` / `rounded-sm`                                       |
| `outline-none`                    | `outline-hidden` (a11y-safe); `outline-none` now truly removes it |
| `ring` (3px)                      | `ring-3`; the default ring is now 1px `currentColor`              |
| `bg-opacity-50`, `text-opacity-*` | opacity modifier: `bg-black/50`, `text-white/50`                  |
| `bg-gradient-to-r`                | `bg-linear-to-r` (plus new `bg-conic-*`, `bg-radial-*`)           |
| `!bg-red-500` (prefix)            | `bg-red-500!` (suffix)                                            |
| `flex-shrink-*` / `flex-grow-*`   | `shrink-*` / `grow-*`                                             |
| `bg-[--var]`                      | `bg-(--var)`; brackets now require `bg-[var(--var)]`              |
| `grid-cols-[a,b]` (commas)        | underscores: `grid-cols-[max-content_auto]`                       |

## Prefer generated utilities over arbitrary values

The spacing scale is infinite — every number compiles via `calc(var(--spacing) * n)` — so most v3-era arbitrary values have a named form:

| Don't                                  | Do                                                                                      |
| -------------------------------------- | --------------------------------------------------------------------------------------- |
| `min-w-[400px]`, `w-[600px]`           | `min-w-100`, `w-150`                                                                    |
| `h-[1.5rem] w-[1.5rem]`                | `size-6`                                                                                |
| `mt-[68px]`                            | `mt-17`                                                                                 |
| `grid-cols-[repeat(15,minmax(0,1fr))]` | `grid-cols-15`                                                                          |
| `h-[100dvh]`, `w-[100dvw]`, `h-[1lh]`  | `h-dvh`, `w-dvw`, `h-lh`                                                                |
| `max-w-[80rem]`                        | `max-w-7xl` (container scale)                                                           |
| `data-[current]:opacity-100`           | `data-current:opacity-100` (values keep brackets: `data-[state=open]:`)                 |
| `bg-[var(--row-bg)]`                   | `bg-(--row-bg)`; type hints when ambiguous: `text-(color:--fg)`, `text-(length:--size)` |

Square brackets remain correct for true one-offs: `max-h-[calc(100dvh-3rem)]`, `grid-cols-[200px_minmax(0,1fr)]`, and arbitrary properties like `[mask-type:luminance]`.

Class strings must stay complete and statically detectable: map props to full strings (`{ success: 'bg-positive1' }[tone]`), never build fragments like `` `bg-${tone}-500` ``.

## Don't hand-write CSS or JS for what a variant covers

Before writing a stylesheet rule, a `style` prop, or an event handler for styling, check for a variant:

| Hand-written                                   | Tailwind                                                                 |
| ---------------------------------------------- | ------------------------------------------------------------------------ |
| `.btn:active { ... }` in CSS                   | `active:bg-surface5`                                                     |
| `:focus-visible` rules                         | `focus-visible:outline-accent1`                                          |
| `[aria-expanded="true"]` selectors             | `aria-expanded:rotate-180` (any `aria-*` boolean or value)               |
| `[data-state="open"]` selectors                | `data-[state=open]:opacity-100`, boolean: `data-current:`                |
| JS hover/focus state to style a sibling/child  | `group`/`group-hover:`, `peer`/`peer-checked:`, `in-focus:`              |
| parent-state selectors / JS "has child" checks | `has-checked:bg-accent1`, `has-[>svg]:pl-8`                              |
| `mask-image` / fade-out gradients in CSS       | `mask-b-from-80%`, `mask-t-from-*`                                       |
| `@media (hover: none)` blocks                  | `pointer-coarse:`/`pointer-fine:`                                        |
| first/last/nth rules in CSS                    | `first:`, `last:`, `odd:`, `nth-3:`, `not-first:`                        |
| styling all children from CSS                  | `*:rounded-full` (children), `**:data-avatar:rounded-full` (descendants) |

## New capabilities — reach for these before hacks or JS

- `field-sizing-content` — auto-growing textarea without a JS resize listener.
- `wrap-anywhere` / `wrap-break-word` — long-word breaking inside flex without the `min-w-0` hack.
- `items-center-safe`, `justify-center-safe` — centering that falls back to `start` on overflow.
- `pointer-coarse:` / `pointer-fine:` — adapt touch targets without user-agent sniffing.
- `user-valid:` / `user-invalid:` — validation styling only after user interaction (unlike `:valid`).
- `starting:` (+ `transition-discrete` for `display`/popover) — enter transitions without JS mount tricks.
- `text-shadow-*`, `mask-t-from-*`/`mask-b-to-*` (fade-out edges), `scheme-dark` (native controls/scrollbars), 3D transforms (`rotate-x-*`, `perspective-*`).

## Behavior changes to remember

- Transforms use individual CSS properties: custom transition lists need `transition-[opacity,scale]`, not `transition-[opacity,transform]`; reset with `scale-none`/`rotate-none`/`translate-none`.
- `hover:` only applies on hover-capable devices (`@media (hover: hover)`) — never gate required touch functionality behind hover.
- Default `border-*`, `divide-*`, ring, and outline colors are `currentColor` — set an explicit color when the color matters.
- Variant stacking applies left to right: v3 `first:*:pt-0` is now `*:first:pt-0`.
- `space-x/y-*` changed selectors (`:not(:last-child)`); prefer flex/grid with `gap-*`.
- Container queries are built in: `@container` on the parent, `@sm:`/`@max-md:` on children.
- Useful v4 variants: `starting:` (enter transitions), `not-*`, `in-*` (like `group-*` without the `group` class), `nth-*`, `*:` (direct children), `**:` (descendants), `inert:`.

## Motion

- Gate decorative animation: `motion-safe:animate-spin motion-reduce:animate-none`.
- Reusable animations are `--animate-*` tokens with their `@keyframes` inside `@theme`; local one-offs use `animate-(--local-animation)` or `animate-[...]`.

© mastra-ai · Apache-2.0 · mastra-ai/mastra

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — tailwind-v4 от других авторов.

tailwind-v4 existential-birds Скилл tailwind-v4 для ИИ-агента, который подсказывает, как настроить Tailwind CSS v4: тема в CSS, токены дизайна, цвета OKLCH и тёмная тема. CX Codex +1 827установок tailwind-v4 boraoztunc Скилл tailwind-v4 для Claude Code и других ИИ-платформ, который автоматизирует миграцию, настройку и отладку Tailwind CSS v4. Запускается при работе с дизайн-токенами или обновлении стилей. CX Codex +1 125установок tailwind-refactor pproenca Скилл tailwind-refactor для рефакторинга классов Tailwind CSS: миграция с v3 на v4, замена устаревших утилит и чистка кода без изменения внешнего вида. CX Codex +1 321установок tailwind-4-docs Lombiq Скилл tailwind-4-docs подтягивает локальный снимок документации Tailwind CSS v4 и помогает агенту отвечать по утилитам, конфигу и миграции с v3. CX Codex +1 19 300установок tailwind-css PaulRBerg Задаёт правила стилизации Tailwind CSS: запрещает ломать вёрстку старых версий синтаксисом v4, требует проверку сборки и инспекцию DOM. CX Codex +1 3 100установок tailwind-patterns coco-research Скилл tailwind-patterns помогает настраивать Tailwind CSS v4 через CSS, собирать адаптивные макеты и проектировать дизайн-токены. Пригодится и при переносе проекта с v3. CX Codex +1 ★ 328звёзд репо tailwind-wasp-drone Legion Code Inc. Субагент tailwind-wasp-drone разбирает настройки и поведение Tailwind CSS v4: от @theme и Vite-плагина до миграции и контейнерных запросов. Для вопросов о механике фреймворка. CX Codex ★ 96звёзд репо tailwindcss-advanced-design-systems JosiahSiegel Скилл tailwindcss-advanced-design-systems для Claude Code помогает собирать дизайн-системы на Tailwind v4. Активируется при настройке @theme, токенов и тем для нескольких брендов. CX Codex +1 659установок

Из того же набора6

react-best-practices Скилл react-best-practices для Claude Code, Cursor, Codex, GitHub Copilot и других агентов: 27 правил по 9 категориям оптимизации React. Подключается при написании, ревью или рефакторинге компонентов. CX Codex +1 2 900установок ralph-plan Скилл ralph-plan для Claude Code помогает по шагам составить команду ralph-loop через диалог и анализ кодовой базы. CX Codex +1 2 600установок e2e-tests-studio Скилл e2e-tests-studio автоматически генерирует Playwright E2E тесты при изменении компонентов playground. Тестирует не состояние интерфейса, а реальное поведение: сохранение данных, потоки данных, эффекты действий. CX Codex +1 2 500установок smoke-test Скилл smoke-test разворачивает проект Mastra через create-mastra и запускает смоук-тест Mastra Studio в Chrome. CX Codex +1 2 500установок mastra-docs Скилл mastra-docs для Claude Code задаёт правила работы с документацией Mastra. Он подключается при создании и проверке страниц, сайдбаров, редиректов и компонентов документации. CX Codex +1 165установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой