tailwindcss-v4
Use when migrating a project from Tailwind v3 to v4, mapping @theme namespaces to generated utilities, or looking up renamed/removed v3 utilities.
How do I install this agent skill?
npx skills add https://github.com/fusengine/claude-plugins --skill tailwindcss-v4Is this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a documentation resource for migrating projects to Tailwind CSS v4. It provides references for new directives, API functions, and installation procedures using official packages. No security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Not the day-to-day CSS-first configuration reference (tailwindcss-core owns @theme/@utility/@variant usage) and not a utility-class lookup (the category skills own that).
</objective>
Tailwind CSS v4.3 Core
Current stable: tailwindcss 4.3.5 (2026-11-06). Minor releases since v4.0: v4.1 (text shadows, masks), v4.2 (mauve/olive/mist/taupe palettes, @tailwindcss/webpack, logical pbs/mbs/inline-*/block-*/inset-s|e|bs|be utilities, font-features-*; start-*/end-* deprecated), v4.3 (scrollbar utilities, @container-size, zoom-*, tab-*, stacked/compound @variant, --default() in functional @utility; v4.3.4 adds @tailwindcss/turbopack, a Turbopack loader for Next.js).
Documentation
- CSS theme variables, design tokens, customization -> tailwindcss-core
- Directives (@utility, @variant, @theme, @apply) -> tailwindcss-core
- Custom utilities and variants -> tailwindcss-custom-styles
- Content detection (@source scanning) -> tailwindcss-core
- Migration from v3 to v4 -> see "v3 → v4 Breaking Changes" section below
Quick Reference - @theme Namespaces
| Namespace | Generated Utilities |
|---|---|
--color-* | bg-, text-, border-, fill- |
--font-* | font-* |
--text-* | text-xs, text-sm, text-base, etc. |
--spacing-* | p-, m-, gap-, w-, h-* |
--radius-* | rounded-* |
--shadow-* | shadow-* |
--breakpoint-* | sm:, md:, lg:, xl: |
--animate-* | animate-spin, animate-bounce, etc. |
--ease-* | ease-in, ease-out, ease-in-out |
v3 → v4 Breaking Changes
Removed @tailwind directives
/* v3 */
@tailwind base;
@tailwind components;
@tailwind utilities;
/* v4 */
@import "tailwindcss";
Renamed utilities
| v3 | v4 |
|---|---|
shadow-sm | shadow-xs |
shadow | shadow-sm |
rounded-sm | rounded-xs |
rounded | rounded-sm |
outline-none | outline-hidden |
ring | ring-3 |
Removed deprecated utilities
bg-opacity-*→ usebg-black/50text-opacity-*→ usetext-black/50flex-shrink-*→ useshrink-*flex-grow-*→ usegrow-*
Custom utilities syntax
/* v3 */
@layer utilities {
.tab-4 {
tab-size: 4;
}
}
/* v4 */
@utility tab-4 {
tab-size: 4;
}
Variables in arbitrary values
<!-- v3 -->
<div class="bg-[--brand-color]"></div>
<!-- v4 -->
<div class="bg-(--brand-color)"></div>
Important modifier position
<!-- v3 -->
<div class="!bg-red-500">
<!-- v4 -->
<div class="bg-red-500!">
Upgrade Tool
npx @tailwindcss/upgrade
Requires Node.js 20+
Detailed References
- configuration.md - Load when writing CSS-first
@themeconfig or using@utility/@variant/@custom-variantdirectives - api-functions.md - Load when using the
--alpha()/--spacing()CSS functions or@apply - installation-support.md - Load when installing Tailwind v4 (npm/Vite/CLI/webpack) or checking browser support
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/fusengine/claude-plugins/tailwindcss-v4">View tailwindcss-v4 on skillZs</a>