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

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

Скилл настраивает Tailwind CSS v4.2 для HyperFrames-композиций и помогает отлаживать стили перед захватом кадров.

Apache-2.0 218 установок ★ 484 обновлён 2026-08-15

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

Что делает tailwind

Скилл описывает работу Tailwind CSS v4.2 в HTML-композициях HyperFrames, созданных через hyperframes init --tailwind. Он помогает писать utility-классы, задавать токены темы через @theme, добавлять собственные утилиты и разбирать ошибки перехода с v3 на v4.

Внутри есть правила для browser runtime @tailwindcss/[email protected], статических классов и детерминированной анимации. Скилл подсказывает, когда вместо runtime собрать CSS-файл, как проверять композицию командами npx hyperframes lint, npx hyperframes validate и npx hyperframes inspect, а также как сделать пробный рендер.

Без window.__tailwindReady HyperFrames может начать захват до появления стилей. Для packages/studio эти правила не подходят: там используется Tailwind v3 с tailwind.config.js, PostCSS и директивами @tailwind.

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

  • настроить Tailwind CSS v4.2 в HyperFrames-композиции
  • перенести токены из tailwind.config.js в @theme
  • заменить динамические классы статическими токенами
  • проверить стили перед захватом кадров
  • выбрать browser runtime или сборку CSS

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

  • Настрой Tailwind для проекта, созданного через hyperframes init --tailwind, и проверь готовность стилей.
  • Замени v3-директивы @tailwind на CSS-first вариант v4 в композиции.
  • Проверь композицию командами npx hyperframes validate и npx hyperframes render . --workers 1 --quality draft --output tailwind-proof.mp4.

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

1Через Skills CLI (Vercel)

npx skills add boraoztunc/skills --skill tailwind -a claude-code

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

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

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

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

Вопросы о tailwind

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

Выполните npx skills add boraoztunc/skills --skill tailwind -a claude-code, затем проверьте файл ~/.claude/skills/tailwind/SKILL.md.

Что делает tailwind?

Скилл задаёт правила для Tailwind CSS v4.2 в HyperFrames-композициях: utility-классы, CSS-first токены, собственные утилиты и проверку стилей перед рендером.

Подходит ли tailwind для packages/studio?

Нет. Скилл рассчитан на композиции из hyperframes init --tailwind, а packages/studio использует Tailwind v3 с tailwind.config.js и PostCSS.

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

SKILL.md · Apache-2.0
---
name: tailwind
description: Tailwind CSS v4.2 browser-runtime patterns for HyperFrames compositions. Use when scaffolding or editing projects created with `hyperframes init --tailwind`, writing Tailwind utility classes in composition HTML, adding CSS-first Tailwind v4 theme tokens, debugging v3 vs v4 syntax, or deciding when to compile Tailwind to CSS instead of using the browser runtime.
---

# Tailwind CSS for HyperFrames

HyperFrames `init --tailwind` uses the Tailwind browser runtime pinned to `@tailwindcss/[email protected]`. Treat that as Tailwind v4, not v3.

This skill is for composition HTML generated by the CLI. It is not for `packages/studio`, which still uses Tailwind v3 internally with `tailwind.config.js`, PostCSS, and `@tailwind` directives.

## When To Use

- The user asks for Tailwind in a HyperFrames composition.
- A project was created with `hyperframes init --tailwind`.
- You see `window.__tailwindReady` in `index.html`.
- You need utility classes, CSS-first theme tokens, custom utilities, or v3-to-v4 migration guidance.
- The render has missing styles and the project is relying on the browser runtime.

## Version Contract

- Pinned runtime: `@tailwindcss/[email protected]`.
- Browser runtime script is injected by the CLI. Do not replace it with `cdn.tailwindcss.com`.
- HyperFrames waits for `window.__tailwindReady` before frame capture starts.
- The readiness shim must stay deterministic: no render-loop polling APIs, no clock-based retries, no runtime network fetches beyond the pinned Tailwind runtime script.
- For offline, locked-down, or production-stable renders, compile Tailwind to CSS and include the stylesheet directly instead of relying on the browser runtime.

## v4 Rules

Tailwind v4 is CSS-first:

```html
<style type="text/tailwindcss">
  @theme {
    --color-brand: oklch(0.68 0.2 252);
    --font-display: "Inter", sans-serif;
  }

  @utility headline-balance {
    text-wrap: balance;
    letter-spacing: 0;
  }
</style>
```

Avoid v3 setup patterns in browser-runtime compositions:

```css
/* Do not use these in Tailwind v4 browser-runtime compositions. */
@tailwind base;
@tailwind components;
@tailwind utilities;
```

Do not add a `tailwind.config.js` just to define colors, fonts, spacing, or utilities for a v4 browser-runtime composition. Use `@theme` and `@utility` in a `text/tailwindcss` style block.

If you truly need an existing JavaScript config for a compiled v4 build, load it explicitly from CSS with `@config`, then validate in the browser. Do not assume v4 auto-detects v3 config files.

## HyperFrames Composition Pattern

Keep Tailwind responsible for static layout and visual style. Keep motion timing in GSAP or another seekable adapter.

```html
<section
  class="clip absolute inset-0 grid place-items-center bg-zinc-950 text-white"
  data-start="0"
  data-duration="5"
  data-track-index="1"
>
  <div class="w-[1280px] max-w-[82vw] text-center">
    <p class="mb-6 text-xl font-medium uppercase tracking-[0.18em] text-cyan-300">
      Render-ready Tailwind
    </p>
    <h1 class="text-7xl font-black leading-none text-balance">
      Utility classes, deterministic frames.
    </h1>
  </div>
</section>
```

For repeated items, prefer class lists plus CSS custom properties over generating class names dynamically:

```html
<span class="inline-block translate-y-[calc(var(--i)*6px)] opacity-80" style="--i: 0"></span>
<span class="inline-block translate-y-[calc(var(--i)*6px)] opacity-80" style="--i: 1"></span>
<span class="inline-block translate-y-[calc(var(--i)*6px)] opacity-80" style="--i: 2"></span>
```

## Dynamic Class Safety

Tailwind's browser runtime scans the current document and generates CSS for class names it can see. Do not build render-critical class names only at seek time:

```js
// Risky: Tailwind may not see every generated class before capture.
element.className = `bg-${color}-500`;
```

Use complete class names in HTML, data attributes, or explicit CSS instead:

```html
<div data-tone="blue" class="bg-blue-500 data-[tone=rose]:bg-rose-500"></div>
```

If a generated class is unavoidable, make sure the full class token appears in a `text/tailwindcss` block before validation.

## Video-Specific Guardrails

- Use stable dimensions: `w-[...]`, `h-[...]`, `aspect-video`, `grid`, `flex`, and fixed padding for video layouts.
- Prefer transforms and opacity for animated properties.
- Keep Tailwind transitions out of render-critical timing unless a seekable runtime owns the state.
- Avoid hover, focus, scroll, viewport, or pointer variants for content that must render deterministically.
- Use explicit border colors. Tailwind v4 changed the default border behavior from v3, so `border border-white/20` is safer than bare `border`.
- Use v4 utility names: `shadow-xs`, `rounded-xs`, `outline-hidden`, `shrink-*`, and `grow-*` where those replacements apply.
- Be careful with modern CSS utilities if the output needs older browser support. Tailwind v4 targets modern browsers.

## Validation

After editing a Tailwind-enabled composition:

```bash
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
```

For a render proof:

```bash
npx hyperframes render . --workers 1 --quality draft --output tailwind-proof.mp4
```

The validation path should show no missing-style flashes on frame 0. If styles appear in preview but not render, check that `window.__tailwindReady` exists and resolves before capture.

## Quick Debug Checklist

1. Confirm the project was scaffolded with `hyperframes init --tailwind`.
2. Confirm the script points to `@tailwindcss/[email protected]`.
3. Confirm `window.__tailwindReady` is present.
4. Replace v3 `@tailwind` directives with v4 browser-runtime CSS.
5. Move custom tokens from `tailwind.config.js` to `@theme`.
6. Replace dynamically assembled classes with complete static tokens.
7. Run `npx hyperframes validate` and render a short proof.

## Credits And References

- Tailwind CSS official v4 installation, upgrade, and compatibility docs: https://tailwindcss.com/docs
- Tailwind CSS v4 release notes: https://tailwindcss.com/blog/tailwindcss-v4
- Community Tailwind skills were reviewed for v4 gotchas and skill shape, but this skill keeps the durable contract in-repo and HyperFrames-specific.

© boraoztunc · Apache-2.0 · boraoztunc/skills

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

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

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

tailwind PyModel С правилами настройки и стилизации на Tailwind CSS v4. Запускается при работе со сборкой, темами через @theme и оптимизацией CSS-бандла. CX Codex +1 671установок tailwind bobmatnyc Разбирает утилитарные классы Tailwind CSS, адаптив, тёмную тему и конфиг. Даёт справку для вёрстки компонентов. CX Codex +1 277установок tailwind oakoss Скилл помогает настраивать Tailwind CSS v4, собирать темы и компоненты, подключать dark mode и разбирать ошибки сборки. CX Codex +1 233установок tailwind-responsive-ui pproenca Скилл tailwind-responsive-ui для Claude и других ИИ-редакторов: помогает переделывать интерфейсы на Tailwind CSS под мобильные и десктопные экраны. CX Codex +1 480установок tailwind-ui-refactor pproenca Скилл tailwind-ui-refactor для Claude Code помогает рефакторить HTML с классами Tailwind, выстраивая иерархию, отступы, типографику и цвет. CX Codex +1 474установок frontend-tailwind-best-practices sergiodxa Скилл frontend-tailwind-best-practices для Claude Code и Codex: 10 правил Tailwind CSS — стеки, отступы через gap, тёмная тема и слияние классов. Контролирует стили компонентов и предотвращает поломку вёрстки. CX Codex +1 470установок tailwind-css manutej По Tailwind CSS: утилитарные классы, адаптивность, тёмная тема и оптимизация сборки. Верстает интерфейс без переключения в CSS-файлы. CX Codex +1 464установок Tailwind CSS taste f Промпт Tailwind CSS taste задаёт стандарты жестикуляции утилитарных стилей Tailwind CSS в ChatGPT, Claude.ai и Claude Code. Настраивает дизайн-токены в теме и запрещает жёстко закодированные пиксельные размеры. GP ChatGPT ★ 178 201звёзд репо hyva-compile-tailwind-css hyva-themes Скилл hyva-compile-tailwind-css автоматизирует сборку Tailwind CSS для тем Hyvä в Magento 2. Запускает продакшен-билд или режим отслеживания изменений, когда новые стили не отображаются на витрине. CX Codex +1 1 300установок

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

Весь набор →
analytics-tracking Скилл analytics-tracking помогает спланировать события, настроить GA4 или GTM и проверить сбор данных. Пригодится при внедрении или аудите аналитики продукта. CX Codex +1 250установок hyperframes Скилл hyperframes для Claude Code создаёт HTML-композиции для видео: анимации, титры, субтитры, озвучку и переходы. Собирает ролики из сцен. CX Codex +1 230установок animejs Помогает встраивать анимации Anime.js в композиции HyperFrames с привязкой к общему таймлайну рендеринга. CX Codex +1 220установок hyperframes-media Скилл hyperframes-media для Claude Code готовит медиа для композиций HyperFrames: озвучивает текст, транскрибирует аудио и видео с таймстампами и удаляет фон. CX Codex +1 218установок hyperframes-cli Скилл hyperframes-cli оркестрирует создание HTML-видео через npx hyperframes: от инициализации проекта до визуального аудита и сборки MP4. CX Codex +1 216установок lottie Учит агента встраивать анимации Lottie и dotLottie в HyperFrames так, чтобы таймлайн можно было перемотать на любой кадр. CX Codex +1 212установок waapi Скилл waapi помогает настроить анимации через Web Animations API для детерминированного рендера в HyperFrames без использования сторонних библиотек вроде GSAP. CX Codex +1 211установок contribute-catalog Скилл contribute-catalog для Claude Code и Codex ведёт создание блока или компонента HyperFrames от идеи до PR в публичный каталог. Задачи: caption styles, VFX, переходы и lower thirds. CX Codex +1 211установок

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

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