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

tailwindcss-performance — скилл для Claude Code: настройка и установка

Скилл tailwindcss-performance для Claude Code помогает ускорить сборку Tailwind CSS и уменьшить размер CSS. Активируется при настройке Tailwind v4, поиске лишних стилей и разборе проблем с динамическими классами.

MIT 239 установок ★ 66 обновлён 2026-06-18

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

Что делает tailwindcss-performance

Скилл разбирает настройки производительности Tailwind CSS: обнаружение файлов с классами, удаление неиспользуемых стилей, минификацию и размер CSS-сборки. Для Tailwind v4 описаны автоматическое обнаружение исходников и способы явно указать файлы через @source.

Для динамических классов предлагаются полные имена классов, атрибуты данных и список классов через @source inline. Скилл также охватывает настройки Vite и PostCSS, извлечение критического CSS, кеширование и переходы. Tailwind не обнаруживает классы, собранные из частей строки, поэтому такие имена нужно задавать целиком или добавлять в список.

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

  • уменьшить размер CSS-сборки
  • настроить поиск файлов с классами Tailwind
  • исправить пропущенные динамические классы
  • включить минификацию CSS в Vite или PostCSS
  • сократить лишние стили и настройки темы

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

  • Разбери сборку Tailwind v4 и найди, что увеличивает размер CSS.
  • Настрой обнаружение исходников Tailwind, чтобы не сканировать лишние файлы.
  • Почему Tailwind не создаёт стили для динамических классов в этом компоненте?

Как установить tailwindcss-performance

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill tailwindcss-performance -a claude-code

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

~/.claude/skills/tailwindcss-performance/SKILL.md

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

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

Вопросы о tailwindcss-performance

Как установить tailwindcss-performance в Claude Code?

Выполни npx skills add JosiahSiegel/claude-plugin-marketplace --skill tailwindcss-performance -a claude-code. Файл скилла появится по пути ~/.claude/skills/tailwindcss-performance/SKILL.md.

Что делает tailwindcss-performance?

Скилл помогает настраивать сборку Tailwind CSS: уменьшать объём CSS, задавать источники классов и разбираться с динамическими именами. В нём также есть рекомендации по минификации и производительности Tailwind v4.

Почему Tailwind не создаёт стили для динамических классов?

Tailwind не распознаёт имена классов, собранные из частей строки. Скилл описывает варианты: использовать полные имена, атрибуты данных или добавить нужные классы через @source inline.

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

SKILL.md · MIT
---
name: tailwindcss-performance
description: |
  Tailwind CSS performance optimization including v4 improvements.
  PROACTIVELY activate for: (1) Tailwind v4 Oxide engine performance, (2) Lightning CSS minification, (3) reducing CSS bundle size, (4) content config tuning to avoid scanning unused files, (5) safelist for dynamic classes (without bloating), (6) production builds with @apply minimization, (7) critical CSS extraction, (8) HTTP caching of generated CSS, (9) avoiding @apply overuse (utility-first preferred), (10) PurgeCSS / content-detection edge cases.
  Provides: performance tuning checklist, Oxide engine notes, content config patterns, safelist guidance, and critical-CSS workflow.
---

# Tailwind CSS Performance Optimization

## v4 Performance Improvements

Tailwind CSS v4 features a completely rewritten engine in Rust:

| Metric | v3 | v4 |
|--------|----|----|
| Full builds | Baseline | Up to 5x faster |
| Incremental builds | Milliseconds | Microseconds (100x+) |
| Engine | JavaScript | Rust |

## JIT (Just-In-Time) Compilation

### How JIT Works

JIT generates styles on-demand as classes are discovered in your files:

1. Scans source files for class names
2. Generates only the CSS you use
3. Produces minimal, optimized output

### v4: Always JIT

Unlike v3, JIT is always enabled in v4—no configuration needed:

```css
@import "tailwindcss";
/* JIT is automatic */
```

## Content Detection

### Automatic Detection (v4)

v4 automatically detects template files—no content configuration required:

```css
/* v4 - Works automatically */
@import "tailwindcss";
```

### Explicit Content (v4)

If automatic detection fails, specify sources explicitly:

```css
@import "tailwindcss";
@source "./src/**/*.{html,js,jsx,ts,tsx,vue,svelte}";
@source "./components/**/*.{js,jsx,ts,tsx}";
```

### Excluding Paths

```css
@source not "./src/legacy/**";
```

## Tree Shaking

### How It Works

Tailwind's build process removes unused CSS:

```text
Source: All possible utilities (~15MB+)
↓
Scan: Find used class names
↓
Output: Only used styles (~10-50KB typical)
```

### Production Build

```bash
# Vite - automatically optimized for production
npm run build

# PostCSS - ensure NODE_ENV is set
NODE_ENV=production npx postcss input.css -o output.css
```

## Dynamic Class Names

### The Problem

Tailwind can't detect dynamically constructed class names:

```javascript
// BAD - Classes won't be generated
const color = 'blue'
className={`text-${color}-500`}  // ❌ Not detected

const size = 'lg'
className={`text-${size}`}  // ❌ Not detected
```

### Solutions

#### 1. Use Complete Class Names

```javascript
// GOOD - Full class names
const colorClasses = {
  blue: 'text-blue-500',
  red: 'text-red-500',
  green: 'text-green-500',
}
className={colorClasses[color]}  // ✓ Detected
```

#### 2. Use Data Attributes

```javascript
// GOOD - Style based on data attributes
<div data-color={color} className="data-[color=blue]:text-blue-500 data-[color=red]:text-red-500">
```

#### 3. Safelist Classes

```css
/* In your CSS for v4 */
@source inline("text-blue-500 text-red-500 text-green-500");
```

#### 4. CSS Variables

```css
@theme {
  --color-dynamic: oklch(0.6 0.2 250);
}
```

```html
<div class="text-[var(--color-dynamic)]">Dynamic color</div>
```

## Optimizing Transitions

### Use Specific Transitions

```html
<!-- SLOW - Transitions all properties -->
<button class="transition-all duration-200">

<!-- FAST - Only transitions specific properties -->
<button class="transition-colors duration-200">
<button class="transition-transform duration-200">
<button class="transition-opacity duration-200">
```

### GPU-Accelerated Properties

Prefer `transform` and `opacity` for smooth animations:

```html
<!-- GOOD - GPU accelerated -->
<div class="transform hover:scale-105 transition-transform">

<!-- GOOD - GPU accelerated -->
<div class="opacity-100 hover:opacity-80 transition-opacity">

<!-- SLOW - May cause repaints -->
<div class="left-0 hover:left-4 transition-all">
```

## CSS Variable Usage

### Prefer Native Variables

In v4, use CSS variables directly instead of `theme()`:

```css
/* v3 - Uses theme() function */
.element {
  color: theme(colors.blue.500);
}

/* v4 - Use CSS variables (faster) */
.element {
  color: var(--color-blue-500);
}
```

### Static Theme Values

For performance-critical paths:

```css
@import "tailwindcss/theme.css" theme(static);
```

This inlines theme values instead of using CSS variables.

## Build Optimization

### Vite Configuration

```javascript
// vite.config.js
import tailwindcss from '@tailwindcss/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [tailwindcss()],
  build: {
    // Minify CSS
    cssMinify: 'lightningcss',
    // Optimize chunks
    rollupOptions: {
      output: {
        manualChunks: {
          // Split vendor CSS if needed
        }
      }
    }
  }
})
```

### PostCSS with cssnano

```javascript
// postcss.config.mjs
export default {
  plugins: {
    '@tailwindcss/postcss': {},
    cssnano: process.env.NODE_ENV === 'production' ? {} : false
  }
}
```

## Reducing Bundle Size

### 1. Avoid Unused Plugins

```css
/* Only load what you need */
@plugin "@tailwindcss/typography";
/* Don't load unused plugins */
```

### 2. Limit Color Palette

```css
@theme {
  /* Disable default colors */
  --color-*: initial;

  /* Define only needed colors */
  --color-primary: oklch(0.6 0.2 250);
  --color-secondary: oklch(0.7 0.15 180);
  --color-gray-100: oklch(0.95 0 0);
  --color-gray-900: oklch(0.15 0 0);
}
```

### 3. Limit Breakpoints

```css
@theme {
  /* Remove unused breakpoints */
  --breakpoint-2xl: initial;

  /* Keep only what you use */
  --breakpoint-sm: 640px;
  --breakpoint-md: 768px;
  --breakpoint-lg: 1024px;
}
```

## Caching Strategies

### Development

- v4's incremental builds are already extremely fast
- No additional caching needed in most cases

### CI/CD

```yaml
# GitHub Actions example
- name: Cache node_modules
  uses: actions/cache@v4
  with:
    path: node_modules
    key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json') }}

- name: Build
  run: npm run build
```

## Measuring Performance

### Build Time Analysis

```bash
# Time your build
time npm run build

# Verbose output
DEBUG=tailwindcss:* npm run build
```

### Bundle Analysis

```bash
# Install analyzer
npm install -D vite-bundle-analyzer

# Analyze bundle
npm run build -- --analyze
```

### CSS Size Check

```bash
# Check output CSS size
ls -lh dist/assets/*.css

# Gzipped size
gzip -c dist/assets/main.css | wc -c
```

## Performance Checklist

### Development

- [ ] JIT is working (styles update instantly)
- [ ] No console warnings about large files
- [ ] Hot reload is fast

### Production

- [ ] `NODE_ENV=production` is set
- [ ] CSS is minified
- [ ] Unused CSS is removed
- [ ] No dynamic class name issues
- [ ] CSS size is reasonable (<50KB typical)

### Common Issues

| Issue | Solution |
|-------|----------|
| Large CSS output | Check for dynamic classes, safelist issues |
| Slow builds | Ensure v4, check file globs |
| Missing styles | Check content detection, class names |
| Slow animations | Use GPU-accelerated properties |

## Lazy Loading CSS

For very large apps, consider code-splitting CSS:

```javascript
// Dynamically import CSS for routes
const AdminPage = lazy(() =>
  import('./admin.css').then(() => import('./AdminPage'))
)
```

## Best Practices Summary

1. **Let JIT do its work** - Don't safelist unnecessarily
2. **Use complete class names** - Avoid dynamic concatenation
3. **Specific transitions** - Not `transition-all`
4. **GPU properties** - Prefer `transform` and `opacity`
5. **Minimal theme** - Only define what you use
6. **Production builds** - Always use production mode
7. **Measure** - Check your actual CSS size

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

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

Все скиллы по теме «Фронтенд и UI» →
tailwind PyModel С правилами настройки и стилизации на Tailwind CSS v4. Запускается при работе со сборкой, темами через @theme и оптимизацией CSS-бандла. CX Codex +1 671установок tailwindcss MengTo Помогает верстать интерфейсы на Tailwind CSS: сетки, типографика, адаптив, темы и паттерны компонентов. CX Codex +1 2 000установок performance-optimization Mindrally Скилл performance-optimization для Claude Code задаёт правила веб-производительности: серверный рендеринг, CSS, JavaScript, ассеты и кэш. Агент применяет их при написании фронтенда. CX Codex +1 907установок postcss-best-practices Mindrally Скилл postcss-best-practices с рекомендациями по настройке PostCSS, сжатию стилей через cssnano и интеграции с Vite, Webpack и Next.js. CX Codex +1 755установок tailwindcss-development laravel Скилл tailwindcss-development пишет и правит Tailwind-классы в Blade, JSX и Vue. Срабатывает сам, когда в запросе встречается слово tailwind. CX Codex +1 1 000установок tailwind-expert 0xfurai Субагент tailwind-expert по Tailwind CSS для Claude Code: помогает настраивать темы, собирать адаптивную вёрстку и чистить стили с PurgeCSS. CX Codex ★ 1 029звёзд репо

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

Весь набор →
tailwindcss-accessibility Скилл tailwindcss-accessibility для Claude Code помогает создавать доступные интерфейсы на Tailwind CSS. Активируется при работе с WCAG, фокусом, контрастом и ARIA. CX Codex +1 302установок tailwindcss-framework-integration Скилл tailwindcss-framework-integration помогает настроить Tailwind CSS в проектах на React, Vite, Next.js, Vue, Nuxt и SvelteKit. Пригодится при подключении плагинов сборщика, тёмной темы и слиянии классов. CX Codex +1 298установок ffmpeg-color-grading-chromakey Скилл ffmpeg-color-grading-chromakey для Claude Code содержит фильтры FFmpeg для удаления хромакея, применения LUT и цветокоррекции видео при автоматизации монтажа ИИ-агентами. CX Codex +1 284установок tailwindcss-advanced-components Скилл tailwindcss-advanced-components для Claude Code помогает собирать варианты React-компонентов на Tailwind CSS с CVA, compound variants и cn. Описывает паттерны в стиле shadcn/ui. CX Codex +1 253установок viral-video-hooks-retention Скилл viral-video-hooks-retention для Claude Code разбирает первые секунды видео: формулы хуков, психологические триггеры и приёмы удержания. Помогает переписать начало ролика или найти просадку в сценарии. CX Codex +1 224установок powershell-shell-detection Скилл powershell-shell-detection помогает определить, где выполняется скрипт: в PowerShell, Git Bash/MSYS2 или cmd. Он пригодится при переносе команд и путей между оболочками Windows. CX Codex +1 211установок tailwindcss-debugging Скилл tailwindcss-debugging помогает ассистенту находить причины пропавших стилей, чинить динамические классы и переводить сборки на Tailwind CSS v4. CX Codex +1 209установок tailwindcss-plugins Скилл tailwindcss-plugins для Claude Code — справочник по официальным и пользовательским плагинам Tailwind CSS. Агент обращается к нему для настройки типографики, форм, container queries и переноса с v3 на v4. CX Codex +1 204установок

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

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