About tailwind4-expert
A specialist skill for Tailwind CSS 4.0+ development, covering CSS-first configuration, Oxide engine performance, and modern CSS features, with guidance for migrating from v3.
Key features
- 01Configure CSS-first themes with @theme
- 02Optimize builds with the Oxide engine
- 03Use native container queries
- 04Set up dynamic utilities and 3D transforms
- 05Follow the v3-to-v4 migration guidance
Use cases
- 01Move design tokens into CSS
- 02Build responsive layouts with container queries
- 03Use custom utilities and dynamic grid values
- 04Migrate from Tailwind CSS v3
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ yuniorglez/ gemini-elite-core --skill tailwind4-expertAfter installing, type/tailwind4-expertin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/1-migration.md2-design-system.md3-layout-and-containers.md4-custom-utilities.mdDetails
From the project README🎨 Skill: tailwind4-expert
Description
Senior specialist in Tailwind CSS 4.0+, focused on the high-performance "Oxide" engine and CSS-first configuration. This skill guides the elimination of JavaScript-heavy build steps in favor of native CSS variables and lightning-fast compilation.
Core Priorities
- CSS-First Configuration: Moving all tokens to
@themeand abandoningtailwind.config.js. - Performance Optimization: Leveraging the Rust-based engine for sub-10ms incremental builds.
- Modern CSS Features: Utilizing native Container Queries, 3D transforms, and
@utilitywithout plugins. - Design System Integrity: Enforcing a strict token-based workflow using CSS variables.
🚀 Top 5 Gains in Tailwind 4.0
- Zero-JS Config: The configuration is the CSS. No more context-switching between JS and CSS files.
- Built-in Container Queries: Native support for
@containerand variants like@md:grid-cols-2. - Dynamic Utilities: Automatic generation of complex utilities like
grid-cols-(--my-grid-count). - Native 3D Transforms: Utilities like
rotate-x-45andperspective-1000work out of the box. - Composability by Default: Every utility is designed to be composed without conflict using the new Oxide engine logic.
🛠️ Implementation Example: The Modern Layout (2026)
Combining Container Queries, 3D Transforms, and @theme variables for a cutting-edge UI.
// 1. Define tokens in globals.css
// @theme { --color-neon: #00f0ff; --perspective-deep: 1200px; }
export function ModernCard() {
return (
<div className="@container perspective-(--perspective-deep) p-8">
<div className="
group relative transform-3d transition-all duration-500
hover:rotate-y-12 hover:rotate-x-6
bg-zinc-900 border border-white/10 rounded-2xl
p-4 @md:p-8 @lg:p-12
">
<div className="text-zinc-400 @md:text-lg @lg:text-2xl font-medium">
Responsive to Parent
</div>
<div className="mt-4 h-1 bg-neon shadow-[0_0_15px_var(--color-neon)]" />
<div className="mt-8 grid grid-cols-1 @md:grid-cols-3 gap-4">
<div className="aspect-square bg-white/5 rounded-lg" />
<div className="aspect-square bg-white/5 rounded-lg" />
<div className="aspect-square bg-white/5 rounded-lg" />
</div>
</div>
</div>
)
}
Table of Contents & Detailed Guides
1. Migration from v3 to v4 — CRITICAL
- Automated upgrade tool (
npx @tailwindcss/upgrade) - Manual migration: Removing
tailwind.config.js - PostCSS vs. Lightning CSS integration
2. The @theme Block & Design Systems — CRITICAL
- Defining colors, fonts, and spacing tokens
- Overriding vs. Extending the default theme
- Using CSS variables (
var(--color-*)) instead oftheme()
3. Advanced Layout & Container Queries — HIGH
- Native Container Query variants (
@md:,@lg:) - Complex Grid configurations with dynamic variables
- 3D Transforms and Perspective
4. Custom Utilities & @utility — MEDIUM
- The new
@utilitydirective syntax - Handling functional/dynamic values in custom classes
- Avoiding arbitrary values with local theme variables
Quick Reference: The "Do's" and "Don'ts"
| Don't | Do |
|---|---|
tailwind.config.js | @theme { ... } in CSS |
@tailwind base; @tailwind components; | @import "tailwindcss"; |
theme('colors.brand') | var(--color-brand) |
arbitrary-vals-[123px] | Define in @theme or local --variable |
npm install @tailwindcss/container-queries | Use native @md: variants |
import { ... } from 'tailwind-merge' | Trust the Oxide engine for composition |
Optimized for Tailwind CSS 4.0+ and Lightning CSS. Updated: January 22, 2026 - 14:59