tailwind-v4-css-variables-enforcer

Audit UI code for Tailwind v4 syntax and CSS variable compliance.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/DaFum/neurotoxic-game --skill tailwind-v4-css-variables-enforcer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tailwind-v4-css-variables-enforcer
Source: https://github.com/DaFum/neurotoxic-game/tree/main/.agents/skills/tailwind-v4-css-variables-enforcer
Command: npx skills add https://github.com/DaFum/neurotoxic-game --skill tailwind-v4-css-variables-enforcer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Audit UI changes to ensure Tailwind v4 syntax and CSS variable usage align with design-system rules and prevent hardcoded colors.

Core Features & Use Cases

  • Detects hardcoded color values across src/index.css and UI components, flags Tailwind v3 bracket-variable usage, and verifies CSS variable token adoption.
  • Recommends compliant replacements that align with the project CSS variables, enabling quick handoffs for design-system compliance.
  • Use Case: A UI team discovers inconsistent color usage across components and runs this audit to bring all styles in line with v4 conventions.

Quick Start

Run the audit-tailwind-v4.sh script to scan for v3 syntax and hardcoded colors and generate a report.

Frequently Asked Questions about tailwind-v4-css-variables-enforcer

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

FAQPage Schema
What is the best way to detect Tailwind v3 bracket-variable patterns in a v4 codebase?

You can detect Tailwind v3 bracket-variable patterns by running a lint script that flags outdated syntax across your components and verifies correct CSS variable token adoption for v4 compliance.

Does this CSS variable audit work with files outside of src/index.css and src/components?

The audit specifically targets src/index.css, src/ui, src/components, and src/scenes to check for hardcoded colors and incorrect token syntax, ensuring focused design-system compliance across key UI directories.

How do I replace hardcoded color values with compliant CSS variable tokens?

Replacing hardcoded color values involves reviewing the generated audit report, which identifies non-compliant colors and provides specific guidance on adopting correct project CSS variable tokens as replacements.

Can I use this audit for an existing design-system or only new Tailwind v4 projects?

You can apply this audit to any codebase using Tailwind v4 and CSS variables, particularly useful when a UI team needs to bring inconsistent existing component styles in line with v4 conventions.