tailwind-upgrade

Migrate Tailwind CSS projects from v3 to v4 with Oxide engine.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/GDSDN/kord-aios --skill tailwind-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailwind-upgrade
Source: https://github.com/GDSDN/kord-aios/tree/main/src/features/builtin-skills/kord-aios/design-system/tailwind-upgrade
Command: npx skills add https://github.com/GDSDN/kord-aios --skill tailwind-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of migrating projects from older versions of Tailwind CSS to the new v4 (Oxide engine), ensuring a smooth transition with minimal disruption.

Core Features & Use Cases

  • Automated Migration: Guides through the upgrade process, from planning to rollout.
  • Configuration Conversion: Handles the shift from tailwind.config.js to CSS-first directives like @theme.
  • Performance Benchmarking: Measures and ensures the new Oxide engine meets performance targets.
  • Regression Testing: Integrates visual and functional testing to catch unintended changes.
  • Use Case: A development team needs to upgrade their large, established project's Tailwind CSS to v4 to leverage performance improvements and new features. This Skill provides a structured, step-by-step playbook to manage the upgrade safely and efficiently.

Quick Start

Execute the tailwind-upgrade skill to begin the migration process from Tailwind CSS v3 to v4.

Frequently Asked Questions about tailwind-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade Tailwind CSS to v4?

To upgrade Tailwind CSS to v4, you need to migrate your configuration from tailwind.config.js to CSS-first @theme directives, adapt to the Oxide engine, and run visual regression tests to ensure UI stability. This process automates that transition safely.

What is the Tailwind CSS v4 Oxide engine migration process?

The Tailwind CSS v4 Oxide engine migration process involves assessing project risks, converting design tokens and utilities to @theme directives, and benchmarking performance against Oxide targets. It orchestrates the shift from older Tailwind versions while ensuring compatibility with existing dependencies.

Does Tailwind CSS v4 require converting the tailwind.config.js file?

Yes, upgrading to Tailwind CSS v4 requires converting your tailwind.config.js file to CSS-first configuration using @theme directives. This migration handles the shift automatically, ensuring your design tokens and utilities integrate smoothly into the new Oxide engine structure.

How do I benchmark frontend performance after a Tailwind CSS upgrade?

You benchmark frontend performance after a Tailwind CSS upgrade by measuring the build and runtime metrics against the Oxide engine targets. This migration process includes performance benchmarking to ensure the new v4 architecture meets your expected speed and efficiency improvements.

Can I integrate visual regression testing during a Tailwind CSS v4 migration?

Yes, you can integrate visual regression testing during a Tailwind CSS v4 migration. The upgrade process includes integration with regression tooling to catch unintended visual and functional changes, ensuring your UI design remains stable across the transition.

What are the limitations of migrating an established project to Tailwind CSS v4?

Migrating an established project to Tailwind CSS v4 carries the risk of dependency conflicts and unintended UI changes from the Oxide engine shift. The migration manages this risk assessment, but complex project structures may require careful manual review of converted design tokens and utilities.