Unslop UI
JCarterJohnson/vibecoded-design-tells
Strips the cues that make a website read as AI-generated and forces a deliberate, project-specific design choice instead of the model's default.
Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup.
Install Tailwind Refactor
$ npx skills add pproenca/dot-skills --skill tailwind-refactor -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pproenca/dot-skills tailwind-refactor --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/tailwind-refactor .claude/skills/tailwind-refactor && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "tailwind-refactor" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactor into .claude/skills/tailwind-refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tailwind-refactor", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pproenca/dot-skills --skill tailwind-refactor -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pproenca/dot-skills tailwind-refactor --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/.experimental/tailwind-refactor .agents/skills/tailwind-refactor && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tailwind-refactor" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactor into .agents/skills/tailwind-refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tailwind-refactor", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill tailwind-refactor -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pproenca/dot-skills tailwind-refactor --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/.experimental/tailwind-refactor .cursor/skills/tailwind-refactor && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tailwind-refactor" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactor into .cursor/skills/tailwind-refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tailwind-refactor", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pproenca/dot-skills.git --path skills/.experimental/tailwind-refactor--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pproenca/dot-skills --skill tailwind-refactor -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pproenca/dot-skills tailwind-refactor --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/.experimental/tailwind-refactor .gemini/skills/tailwind-refactor && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tailwind-refactor" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactor into .gemini/skills/tailwind-refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tailwind-refactor", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pproenca/dot-skills tailwind-refactorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pproenca/dot-skills --skill tailwind-refactor -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/.experimental/tailwind-refactor .github/skills/tailwind-refactor && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tailwind-refactor" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactor into .github/skills/tailwind-refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tailwind-refactor", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill tailwind-refactor -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pproenca/dot-skills tailwind-refactor --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/.experimental/tailwind-refactor .opencode/skills/tailwind-refactor && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tailwind-refactor" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.experimental/tailwind-refactor into .opencode/skills/tailwind-refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tailwind-refactor", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tailwind-refactor- GitHub stars
- 214
- Token cost
- ~2.2k tokens
- SKILL.md length
- 609 words
- Files
- 54 (incl. references, assets)
- Skills in repo
- 182
- Repo updated
- First seen
- Licence
- MIT
At a glance
Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup.
- Works in 8 steps: Configuration Migration (CRITICAL) → Deprecated Utility Replacement (CRITICAL) → Renamed Utility Updates (HIGH) → …
- Tasks involving Tailwind CSS cleanup
- SKILL.md covers When to Apply, Rule Categories by Priority, Quick Reference and How to Use, plus 1 more section
- Calls npx
What it does
Tailwind Refactor is an agent skill from pproenca/dot-skills. Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup. This skill should be used when refactoring Tailwind utility classes, migrating from v3 to v4, cleaning up deprecated utilities, consolidating verbose class patterns, or removing code smells — all without changing the visual output. Triggers on tasks involving Tailwind CSS cleanup, v4 migration, class refactoring, @apply removal, or utility modernization.
Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 56 other files, including reference files and assets (for example `assets/templates/_template.md`, `metadata.json` and `references/_sections.md`).
It sits in Frontend & Design, covering Refactoring, CSS and styling and Legacy modernization. It works with Tailwind CSS. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.
When your agent uses it
- Tasks involving Tailwind CSS cleanup
- Class refactoring
- Utility modernization
Example prompts
- “/tailwind-refactor”
Requirements
- Node.js
Workflow steps
8 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Tailwind Refactor loads about 2.2k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 114 tokens; SKILL.md has 609 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 609 words, ~2,170 tokens.
Download SKILL.mdSave it as
.claude/skills/tailwind-refactor/SKILL.md (or your agent's skills folder). This skill also uses 53 other files; get the full folder from GitHub.- name
- tailwind-refactor
- description
- Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup. This skill should be used when refactoring Tailwind utility classes, migrating from v3 to v4, cleaning up deprecated utilities, consolidating verbose class patterns, or removing code smells — all without changing the visual output. Triggers on tasks involving Tailwind CSS cleanup, v4 migration, class refactoring, @apply removal, or utility modernization.
Community Tailwind CSS Refactoring Best Practices
Comprehensive code quality refactoring guide for Tailwind CSS applications targeting v4. Contains 50 rules across 8 categories, prioritized by migration urgency. Every transformation preserves the existing look and feel — this skill is purely about cleaner code, modern syntax, and v4 compatibility.
Companion skills: Use tailwind-ui-refactor for visual design improvements and tailwind-responsive-ui for responsive layout patterns.
When to Apply
Before manual migration: Run npx @tailwindcss/upgrade first — it handles most configuration and renamed utility changes automatically. Then use this skill for patterns the automated tool does not cover.
Reference these guidelines when:
- Migrating a project from Tailwind CSS v3 to v4
- Cleaning up deprecated or renamed utility classes
- Consolidating verbose multi-class patterns
- Replacing arbitrary values with design tokens
- Removing
@applyoveruse in CSS files - Modernizing syntax to v4 conventions
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Configuration Migration | CRITICAL | config- |
| 2 | Deprecated Utility Replacement | CRITICAL | dep- |
| 3 | Renamed Utility Updates | HIGH | rename- |
| 4 | Class Consolidation | HIGH | class- |
| 5 | Arbitrary Value Cleanup | MEDIUM-HIGH | arb- |
| 6 | Syntax Modernization | MEDIUM | syntax- |
| 7 | @apply & Architecture Cleanup | MEDIUM | arch- |
| 8 | Modern Feature Adoption | LOW-MEDIUM | adopt- |
Quick Reference
1. Configuration Migration (CRITICAL)
config-import-directive- Replace @tailwind directives with @importconfig-css-theme- Migrate tailwind.config.js to CSS @themeconfig-theme-function- Replace theme() function with CSS variablesconfig-theme-inline- Use @theme inline for non-utility design tokensconfig-utility-directive- Replace @layer utilities with @utilityconfig-postcss-plugin- Update PostCSS plugin to @tailwindcss/postcssconfig-content-autodetect- Remove manual content configurationconfig-custom-variant- Migrate addVariant to @custom-variantconfig-preflight-defaults- Account for Preflight default changes in v4
2. Deprecated Utility Replacement (CRITICAL)
dep-opacity-modifiers- Replace -opacity- with opacity modifiers (/50)dep-flex-shorthand- Replace flex-shrink/flex-grow with shrink/growdep-text-ellipsis- Replace overflow-ellipsis with text-ellipsisdep-decoration-utilities- Replace decoration-slice/clone with box-decoration-*dep-transform-composites- Replace transform-none with individual resetsdep-transition-properties- Update transition-[transform] to individual properties
3. Renamed Utility Updates (HIGH)
rename-shadow-scale- Update shadow utilities to new scalerename-blur-scale- Update blur utilities to new scalerename-rounded-scale- Update border radius utilities to new scalerename-ring-width- Replace ring with ring-3 for v3 defaultrename-gradient-utilities- Replace bg-gradient-* with bg-linear-*rename-outline-hidden- Replace outline-none with outline-hidden
4. Class Consolidation (HIGH)
class-size-utility- Replace matching w-* h-* with size-*class-gap-over-space- Prefer gap-* over space-x/y-* in flex/gridclass-inset-shorthand- Replace top/right/bottom/left with inset-*class-border-color-explicit- Add explicit border color for v4 default changeclass-ring-color-explicit- Add explicit ring color for v4 default changeclass-redundant-display- Remove redundant display classesclass-hidden-priority- Remove display overrides for hidden attributeclass-container-utility- Replace container plugin config with @utility
Show full SKILL.md (216 more words)Show less
5. Arbitrary Value Cleanup (MEDIUM-HIGH)
arb-hex-to-theme- Replace arbitrary hex colors with theme tokensarb-spacing-to-scale- Replace arbitrary spacing with theme scalearb-dynamic-classes- Avoid dynamic class name constructionarb-breakpoint-to-theme- Replace arbitrary breakpoints with @themearb-zindex-to-scale- Replace arbitrary z-index with defined scale
6. Syntax Modernization (MEDIUM)
syntax-css-variable-parens- Update CSS variable syntax from brackets to parenthesessyntax-variant-stacking- Update variant stacking to left-to-right ordersyntax-important-modifier- Use trailing ! for important modifiersyntax-grid-arbitrary- Use underscores in grid arbitrary valuessyntax-gradient-preservation- Reset gradient stops explicitly in variantssyntax-hover-media-query- Account for hover variant media query wrapping
7. @apply & Architecture Cleanup (MEDIUM)
arch-apply-to-component- Extract @apply blocks into framework componentsarch-layer-to-utility- Replace @layer components with @utilityarch-scoped-reference- Use @reference for @apply in scoped stylesarch-safelist-to-source- Replace safelist with @source inline()arch-domain-composition- Reserve Tailwind for primitives, compose for domain
8. Modern Feature Adoption (LOW-MEDIUM)
adopt-container-queries- Use container queries instead of viewport breakpointsadopt-not-variant- Use not-* variant for negated conditionsadopt-in-variant- Use in-* variant to simplify parent-state stylingadopt-field-sizing- Use field-sizing-content for auto-resizing textareasadopt-starting-variant- Use starting variant for entry animations without JS
How to Use
Read individual reference files for detailed explanations and code examples:
- Section definitions - Category structure and impact levels
- Rule template - Template for adding new rules
Reference Files
| File | Description |
|---|---|
| references/_sections.md | Category definitions and ordering |
| assets/templates/_template.md | Template for new rules |
| metadata.json | Version and reference information |
© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 53 other files (references, assets) in skills/.experimental/tailwind-refactor of pproenca/dot-skills.
- SKILL.md
- assets/templates/_template.md
- metadata.json
- references/_sections.md
- references/adopt-container-queries.md
- references/adopt-field-sizing.md
- references/adopt-in-variant.md
- references/adopt-not-variant.md
- references/adopt-starting-variant.md
- references/arb-breakpoint-to-theme.md
- references/arb-dynamic-classes.md
- references/arb-hex-to-theme.md
- references/arb-spacing-to-scale.md
- references/arb-zindex-to-scale.md
- references/arch-apply-to-component.md
- references/arch-domain-composition.md
- references/arch-layer-to-utility.md
- references/arch-safelist-to-source.md
- … and 36 more
Open the folder on GitHubat commit cf93c57
Compare with similar skills
Tailwind Refactor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Tailwind Refactor this skillpproenca/dot-skills | 214 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Unslop UIJCarterJohnson/vibecoded-design-tells | 508 | — | ~1.9k | Automated safety check: Pass | Custom licence | |
| Frontend Code Stylemailtrap/mailtrap-local | 106 | — | ~2.7k | Automated safety check: Pass | MIT | |
| Frontend UI FunctionalvictorGPT/vibeusage | 131 | — | ~939 | Automated safety check: Pass | MIT | |
| Tailwind V4mastra-ai/mastra | 29k | — | ~2.5k | Automated safety check: Pass | Custom licence | |
| Bulletproof Frontendaaddrick/claude-pipeline | 130 | — | ~1k | Automated safety check: Pass | MIT |
Similar skills
Frontend Code Style
mailtrap/mailtrap-local
A skill your agent uses when writing or refactoring React + Tailwind v4 code in this repo.
Frontend UI Functional
victorGPT/vibeusage
A skill your agent uses when building or refactoring functional React/Vite/Tailwind UI pages, templates, or component libraries that need consistent structure, tokenized styling, accessibility…
Tailwind V4
mastra-ai/mastra
Tailwind CSS v4 usage guide and v3-to-v4 differences. An agent skill from mastra-ai/mastra.
Bulletproof Frontend
aaddrick/claude-pipeline
Bulletproof CSS and frontend design principles from "Handcrafted CSS" by Dan Cederholm.
Frontend Development
avibebuilder/claude-prime
A skill your agent uses for ANY work involving React, Next.js, TypeScript, or Tailwind in the browser layer.
More from pproenca/dot-skills
All 182 skills in this repoAudio Voice Recovery
pproenca/dot-skills
Audio forensics and voice recovery guidelines for CSI-level audio analysis.
Codemod React Pipeline
pproenca/dot-skills
Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.
Dev Rfc
pproenca/dot-skills
Create well-structured RFCs and technical proposals for software projects.
Dx Harness
pproenca/dot-skills
Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.
Language Spec Author
pproenca/dot-skills
Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…
Python Pep Author
pproenca/dot-skills
Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…
Related
Works with
Categories
Questions about Tailwind Refactor
What does Tailwind Refactor do?
Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup. Tailwind Refactor is an agent skill from pproenca/dot-skills. Tailwind CSS code refactoring patterns for v4 migration and anti-pattern cleanup.
When should I use Tailwind Refactor?
Tailwind Refactor fits situations like: tasks involving Tailwind CSS cleanup; class refactoring; utility modernization.
How do I install Tailwind Refactor in Claude Code?
Run `npx skills add pproenca/dot-skills --skill tailwind-refactor -a claude-code`. Or copy the skill folder (skills/.experimental/tailwind-refactor in pproenca/dot-skills) into .claude/skills/tailwind-refactor in your project. Claude Code loads it when a task matches its description.
How do I install Tailwind Refactor in Codex?
Run `npx skills add pproenca/dot-skills --skill tailwind-refactor -a codex`. Or copy the skill folder (skills/.experimental/tailwind-refactor in pproenca/dot-skills) into .agents/skills/tailwind-refactor in your project. Codex loads it when a task matches its description.
Can I use Tailwind Refactor in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill tailwind-refactor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tailwind-refactor, .gemini/skills/tailwind-refactor, .github/skills/tailwind-refactor and .opencode/skills/tailwind-refactor in your project.
What does Tailwind Refactor need to run?
Going by SKILL.md and its folder, Tailwind Refactor needs the command-line tools its instructions call (npx). Our summary lists: Node.js.
Does Tailwind Refactor access the network?
SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Tailwind Refactor safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Tailwind Refactor use?
Tailwind Refactor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Tailwind Refactor use?
About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.
What are the alternatives to Tailwind Refactor?
Skills that share tags, products or a category with Tailwind Refactor: Unslop UI (JCarterJohnson/vibecoded-design-tells, 508 stars), Frontend Code Style (mailtrap/mailtrap-local, 106 stars), Frontend UI Functional (victorGPT/vibeusage, 131 stars) and Tailwind V4 (mastra-ai/mastra, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Tailwind Refactor?
pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.
Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.