Tailwindcss Skill

Tailwind CSS Agent Skill

An open Agent Skill for Tailwind CSS v4 — version-aware implementation, migration, debugging, and verification. The skill follows the [Agent Skills](https://agentskills.io/specification) standard and is known to install into the runtimes listed below.

Why this exists

The skill interrupts specific failure modes that `SKILL.md` treats as rules:

• Mixing v3 and v4 configuration. Adding content: [] or @tailwind directives to a v4 project, or assuming tailwind.config.js is required when it isn't.
• Replacing a working integration. Swapping an existing @tailwindcss/vite or @tailwindcss/postcss setup for the CLI just because the CLI is available.
• Constructing class names Tailwind cannot discover. Writing bg-${color}-600 produces no styles, because Tailwind scans source as plain text and never sees the complete token.
• Introducing arbitrary values when theme tokens exist. Reaching for bg-[#bada55] when the project already defines --color-brand and should extend it instead.
• Claiming success without verifying emitted CSS. Reporting a change as done without running the build and confirming the utility is present in the output.

How it works

The agent follows a fixed workflow defined in `SKILL.md`:

1. Detect — read package.json, lockfile, vite.config.*, postcss.config.*, CSS entrypoin