tailwind
Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style). This skill should be used when writing, reviewing, or refactoring Tailwind CSS v4 code to ensure optimal build performance, minimal CSS output, and correct usage of v4 features. Triggers on tasks involving Tailwind configuration, @theme directive, utility classes, responsive design, dark mode, container queries, or CSS generation optimization.
- License 许可
- MIT
- 最近更新
- 2026-08-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- tailwind
- description
- Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style). This skill should be used when writing, reviewing, or refactoring Tailwind CSS v4 code to ensure optimal build performance, minimal CSS output, and correct usage of v4 features. Triggers on tasks involving Tailwind configuration, @theme directive, utility classes, responsive design, dark mode, container queries, or CSS generation optimization.
02 资源文件 47
- 参考文档AGENTS.md9.0 KB
- 资产文件assets/templates/_template.md878 B
- 参考文档references/_sections.md2.0 KB
- 参考文档references/anim-3d-transforms.md2.0 KB
- 参考文档references/anim-gpu-accelerated.md1.4 KB
- 参考文档references/anim-gradient-interpolation.md1.3 KB
- 参考文档references/anim-starting-style.md1.4 KB
- 参考文档references/build-cli-package.md924 B
- 参考文档references/build-content-detection.md1.2 KB
- 参考文档references/build-css-import.md994 B
- 参考文档references/build-node-version.md1.0 KB
- 参考文档references/build-postcss-simplify.md1.1 KB
- 参考文档references/build-vite-plugin.md1.3 KB
- 参考文档references/bundle-avoid-cdn-production.md1.3 KB
- 参考文档references/bundle-avoid-preprocessors.md1.2 KB
- 参考文档references/bundle-css-minification.md1.3 KB
- 参考文档references/bundle-remove-unused-plugins.md1.2 KB
- 参考文档references/bundle-split-critical-css.md1.8 KB
- 参考文档references/comp-avoid-apply-overuse.md1.5 KB
- 参考文档references/comp-container-customize.md1.1 KB
- 参考文档references/comp-custom-variant.md1.7 KB
- 参考文档references/comp-reference-directive.md1.3 KB
- 参考文档references/comp-smart-sorting.md1.3 KB
- 参考文档references/comp-utility-file-scope.md1.3 KB
- 参考文档references/gen-avoid-theme-bloat.md2.0 KB
- 参考文档references/gen-css-first-config.md1.3 KB
- 参考文档references/gen-css-variable-syntax.md1.1 KB
- 参考文档references/gen-dynamic-utilities.md1.3 KB
- 参考文档references/gen-oklch-colors.md1.0 KB
- 参考文档references/gen-utility-directive.md1.2 KB
- 参考文档references/resp-container-queries.md1.4 KB
- 参考文档references/resp-custom-breakpoints.md1.2 KB
- 参考文档references/resp-hover-capability.md1.7 KB
- 参考文档references/resp-logical-properties.md1.4 KB
- 参考文档references/resp-mobile-first.md1.4 KB
- 参考文档references/theme-color-scheme.md1.4 KB
- 参考文档references/theme-dark-mode-class.md1.4 KB
- 参考文档references/theme-inline-static.md1.8 KB
- 参考文档references/theme-prefix-variables.md1.2 KB
- 参考文档references/theme-runtime-variables.md1.3 KB
- 参考文档references/theme-semantic-tokens.md1.5 KB
- 参考文档references/util-explicit-colors.md1.2 KB
- 参考文档references/util-gradient-via-none.md1.2 KB
- 参考文档references/util-important-modifier.md954 B
- 参考文档references/util-opacity-modifier.md1.1 KB
- 参考文档references/util-renamed-utilities.md1.4 KB
- 参考文档references/util-variant-stacking.md1.1 KB
03 SKILL.md 正文
Community Tailwind CSS v4 Best Practices
Comprehensive performance optimization guide for Tailwind CSS v4 applications. Contains 44 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
When to Apply
Reference these guidelines when:
- Configuring Tailwind CSS v4 build tooling (Vite plugin, PostCSS, CLI)
- Writing or migrating styles using v4's CSS-first approach
- Optimizing CSS bundle size and build performance
- Implementing responsive designs with breakpoints or container queries
- Setting up theming with @theme directive and design tokens
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Build Configuration | CRITICAL | build- |
| 2 | CSS Generation | CRITICAL | gen- |
| 3 | Bundle Optimization | HIGH | bundle- |
| 4 | Utility Patterns | HIGH | util- |
| 5 | Component Architecture | MEDIUM-HIGH | comp- |
| 6 | Theming & Design Tokens | MEDIUM | theme- |
| 7 | Responsive & Adaptive | MEDIUM | resp- |
| 8 | Animation & Transitions | LOW-MEDIUM | anim- |
Quick Reference
1. Build Configuration (CRITICAL)
build-vite-plugin- Use Vite Plugin Over PostCSSbuild-css-import- Use CSS Import Over @tailwind Directivesbuild-content-detection- Leverage Automatic Content Detectionbuild-node-version- Use Node.js 20+ for Optimal Performancebuild-postcss-simplify- Remove Redundant PostCSS Pluginsbuild-cli-package- Use Correct CLI Package
2. CSS Generation (CRITICAL)
gen-css-first-config- Use CSS-First Configuration Over JavaScriptgen-avoid-theme-bloat- Avoid Excessive Theme Variablesgen-oklch-colors- Use OKLCH Color Space for Vivid Colorsgen-utility-directive- Use @utility for Custom Utilitiesgen-dynamic-utilities- Use Dynamic Utility Valuesgen-css-variable-syntax- Use Parentheses for CSS Variable References
3. Bundle Optimization (HIGH)
bundle-remove-unused-plugins- Remove Built-in Pluginsbundle-avoid-preprocessors- Avoid Sass/Less Preprocessorsbundle-css-minification- Enable CSS Minification in Productionbundle-avoid-cdn-production- Avoid Play CDN in Productionbundle-split-critical-css- Extract Critical CSS for Initial Render
4. Utility Patterns (HIGH)
util-renamed-utilities- Use Renamed Utility Classesutil-important-modifier- Use Trailing Important Modifierutil-variant-stacking- Use Left-to-Right Variant Stackingutil-explicit-colors- Use Explicit Border and Ring Colorsutil-opacity-modifier- Use Slash Opacity Modifierutil-gradient-via-none- Use via-none to Reset Gradient Stops
5. Component Architecture (MEDIUM-HIGH)
comp-avoid-apply-overuse- Avoid Overusing @applycomp-reference-directive- Use @reference for CSS Module Integrationcomp-utility-file-scope- Understand Utility File Scopecomp-smart-sorting- Leverage Smart Utility Sortingcomp-container-customize- Customize Container with @utilitycomp-custom-variant- Use @custom-variant for Custom Variant Definitions
6. Theming & Design Tokens (MEDIUM)
theme-semantic-tokens- Use Semantic Design Token Namestheme-dark-mode-class- Use Class-Based Dark Mode for Controltheme-prefix-variables- Use Prefix for Variable Namespacingtheme-runtime-variables- Leverage Runtime CSS Variablestheme-color-scheme- Set color-scheme for Native Dark Modetheme-inline-static- Use @theme inline and @theme static for Variable Control
7. Responsive & Adaptive (MEDIUM)
resp-mobile-first- Use Mobile-First Responsive Designresp-container-queries- Use Container Queries for Component-Level Responsivenessresp-custom-breakpoints- Define Custom Breakpoints in @themeresp-hover-capability- Pair Hover with Active for Touch-Friendly Interactionsresp-logical-properties- Use Logical Properties for RTL Support
8. Animation & Transitions (LOW-MEDIUM)
anim-gpu-accelerated- Use GPU-Accelerated Transform Propertiesanim-starting-style- Use @starting-style for Entry Animationsanim-gradient-interpolation- Use OKLCH Gradient Interpolationanim-3d-transforms- Use Built-in 3D Transform Utilities
How to Use
Read individual reference files for detailed explanations and code examples:
- Section definitions - Category structure and impact levels
- Rule template - Template for adding new rules
Full Compiled Document
For a complete guide with all rules expanded, see AGENTS.md.
Reference Files
| File | Description |
|---|---|
| AGENTS.md | Complete compiled guide with all rules |
| references/_sections.md | Category definitions and ordering |
| assets/templates/_template.md | Template for new rules |
| metadata.json | Version and reference information |
04 同仓库更多 Skills
zustand
Rules and standards for state management using Zustand in React and Next.js. Use when implementing client-side stores, persistence with localStorage, or preventing SSR hydration mismatch.
zod
Zod v4 schema validation best practices. Use when defining schemas, utilizing safeParse, or customizing error messages.
upstash-ratelimit
Rules, standards, and references for rate limiting in serverless environments using Upstash Ratelimit. Use when implementing rate limiting, configuring Upstash Redis, or handling request blocking.
ui-design
UI/UX and frontend design best practices guidelines (formerly frontend-design). This skill should be used when writing, reviewing, or designing frontend code to ensure accessibility, performance, and usability. Triggers on tasks involving HTML structure, CSS styling, responsive layouts, form design, animations, or accessibility improvements.
typescript
TypeScript performance, tsconfig, type errors, async patterns — triggered when the user asks to "optimize TypeScript performance", "speed up tsc compilation", "configure tsconfig.json", "fix type errors", "improve async patterns", or encounters TS errors (TS2322, TS2339, "is not assignable to"). Also triggers on .ts, .tsx, .d.ts file work involving type definitions, module organization, or memory management. Does NOT cover TypeScript basics, framework-specific patterns, or testing.
typescript-refactor
TypeScript and TSX refactoring and modernization guidelines from a principal specialist perspective, current to TypeScript 6.0 and React 19. This skill should be used when refactoring, reviewing, or modernizing TypeScript or React/TSX code for type safety, compiler performance, and idiomatic patterns. Triggers on tasks involving type architecture, narrowing, generics, discriminated unions, error handling, React component and hook typing, or migration to modern TypeScript features (satisfies, using, const type parameters, inferred type predicates, isolatedDeclarations, erasable syntax, import attributes).