Agent skill

Tailwind

by pproenca in pproenca/dot-skills

Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style).

MITAuto-check passedFrontend & Design

Install Tailwind

skills CLI
$ npx skills add pproenca/dot-skills --skill tailwind -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pproenca/dot-skills tailwind --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/tailwind .claude/skills/tailwind && rm -rf skills-src

Use ~/.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/

Facts

Skill name
tailwind
GitHub stars
214
Token cost
~1.8k tokens
SKILL.md length
492 words
Files
50 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style).

  • Works in 8 steps: Build Configuration (CRITICAL) → CSS Generation (CRITICAL) → Bundle Optimization (HIGH) → …
  • Tasks involving Tailwind configuration
  • SKILL.md covers When to Apply, Rule Categories by Priority, Quick Reference and How to Use, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tailwind is an agent skill from pproenca/dot-skills. Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style). This skill should be used when writing, reviewing, or refactoring Tailwind CSS v4 code to ensure optimal build performance, minimal CSS output, and correct usage of v4 features. Triggers on tasks involving Tailwind configuration, @theme directive, utility classes, responsive design, dark mode, container queries, or CSS generation optimization.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 52 other files, including reference files and assets (for example `AGENTS.md`, `README.md` and `assets/templates/_template.md`).

It sits in Frontend & Design, covering CSS and styling, Theming and dark mode and Responsive design. It works with Tailwind CSS and Vite. 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 configuration
  • @theme directive
  • Utility classes
  • Responsive design

Example prompts

  • “/tailwind”

Requirements

  • Node.js

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Build Configuration (CRITICAL)
  2. CSS Generation (CRITICAL)
  3. Bundle Optimization (HIGH)
  4. Utility Patterns (HIGH)
  5. Component Architecture (MEDIUM-HIGH)
  6. Theming & Design Tokens (MEDIUM)
  7. Responsive & Adaptive (MEDIUM)
  8. Animation & Transitions (LOW-MEDIUM)

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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 loads about 1.8k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 115 tokens; SKILL.md has 492 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~115
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~17k

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). 492 words, ~1,817 tokens.

Download SKILL.mdSave it as .claude/skills/tailwind/SKILL.md (or your agent's skills folder). This skill also uses 49 other files; get the full folder from GitHub.
name
tailwind
description
Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style). This skill should be used when writing, reviewing, or refactoring Tailwind CSS v4 code to ensure optimal build performance, minimal CSS output, and correct usage of v4 features. Triggers on tasks involving Tailwind configuration, @theme directive, utility classes, responsive design, dark mode, container queries, or CSS generation optimization.

Community Tailwind CSS v4 Best Practices

Comprehensive performance optimization guide for Tailwind CSS v4 applications. Contains 44 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

  • Configuring Tailwind CSS v4 build tooling (Vite plugin, PostCSS, CLI)
  • Writing or migrating styles using v4's CSS-first approach
  • Optimizing CSS bundle size and build performance
  • Implementing responsive designs with breakpoints or container queries
  • Setting up theming with @theme directive and design tokens

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Build ConfigurationCRITICALbuild-
2CSS GenerationCRITICALgen-
3Bundle OptimizationHIGHbundle-
4Utility PatternsHIGHutil-
5Component ArchitectureMEDIUM-HIGHcomp-
6Theming & Design TokensMEDIUMtheme-
7Responsive & AdaptiveMEDIUMresp-
8Animation & TransitionsLOW-MEDIUManim-

Quick Reference

1. Build Configuration (CRITICAL)
2. CSS Generation (CRITICAL)
3. Bundle Optimization (HIGH)
4. Utility Patterns (HIGH)
Show full SKILL.md (212 more words)Show less
5. Component Architecture (MEDIUM-HIGH)
6. Theming & Design Tokens (MEDIUM)
7. Responsive & Adaptive (MEDIUM)
8. Animation & Transitions (LOW-MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Full Compiled Document

For a complete guide with all rules expanded, see AGENTS.md.

Reference Files

FileDescription
AGENTS.mdComplete compiled guide with all rules
references/_sections.mdCategory definitions and ordering
assets/templates/_template.mdTemplate for new rules
metadata.jsonVersion 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 49 other files (references, assets) in skills/.curated/tailwind of pproenca/dot-skills.

  • SKILL.md
  • AGENTS.md
  • README.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/anim-3d-transforms.md
  • references/anim-gpu-accelerated.md
  • references/anim-gradient-interpolation.md
  • references/anim-starting-style.md
  • references/build-cli-package.md
  • references/build-content-detection.md
  • references/build-css-import.md
  • references/build-node-version.md
  • references/build-postcss-simplify.md
  • references/build-vite-plugin.md
  • references/bundle-avoid-cdn-production.md
  • references/bundle-avoid-preprocessors.md
  • … and 32 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

Tailwind 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.

Tailwind compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tailwind this skillpproenca/dot-skills214—~1.8kAutomated safety check: PassMIT
Shadcn Tailwind UILiarMTTT/TavernWeave148—~1.7kAutomated safety check: PassCustom licence
Tailwindcsseinverne/dotfiles121—~6.5kAutomated safety check: PassMIT
UI StylingOhh-889/skyroc79513 repos~2.5kAutomated safety check: PassMIT
Tailwind Theme Builderjezweb/claude-skills1.1k1 repos~3.2kAutomated safety check: PassMIT
Tailwind CSS Patternsever-works/ever-works1583 repos~1.6kAutomated safety check: NotesAGPL-3.0

Similar skills

  • Shadcn Tailwind UI

    LiarMTTT/TavernWeave

    Build, restyle, or review accessible React interfaces that use shadcn/ui, Radix UI primitives, and Tailwind CSS.

    148 GitHub stars~1.7k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Tailwindcss

    einverne/dotfiles

    Guide for implementing Tailwind CSS - a utility-first CSS framework for rapid UI development.

    121 GitHub stars~6.5k tokensUpdated 28 days ago
    Frontend & DesignAuto-check passed
  • UI Styling

    Ohh-889/skyroc

    Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs.

    795 GitHub starsUsed in 13 repos~2.5k tokens
    Frontend & DesignAuto-check passed
  • Tailwind Theme Builder

    jezweb/claude-skills

    Set up Tailwind v4 + shadcn/ui themed UI with dark mode. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3.2k tokens
    Frontend & DesignAuto-check passed
  • Tailwind CSS Patterns

    ever-works/ever-works

    Provides comprehensive Tailwind CSS utility-first styling patterns including responsive design, layout utilities, flexbox, grid, spacing, typography, colors, and modern CSS best practices.

    158 GitHub starsUsed in 3 repos~1.6k tokens
    Frontend & DesignAuto-check: notes
  • 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…

    131 GitHub stars~939 tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • 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…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • 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…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Tailwind

What does Tailwind do?

Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style). Tailwind is an agent skill from pproenca/dot-skills. Tailwind CSS v4 performance optimization and best practices guidelines (formerly tailwindcss-v4-style).

When should I use Tailwind?

Tailwind fits situations like: tasks involving Tailwind configuration; @theme directive; utility classes; responsive design.

How do I install Tailwind in Claude Code?

Run `npx skills add pproenca/dot-skills --skill tailwind -a claude-code`. Or copy the skill folder (skills/.curated/tailwind in pproenca/dot-skills) into .claude/skills/tailwind in your project. Claude Code loads it when a task matches its description.

How do I install Tailwind in Codex?

Run `npx skills add pproenca/dot-skills --skill tailwind -a codex`. Or copy the skill folder (skills/.curated/tailwind in pproenca/dot-skills) into .agents/skills/tailwind in your project. Codex loads it when a task matches its description.

Can I use Tailwind 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 -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, .gemini/skills/tailwind, .github/skills/tailwind and .opencode/skills/tailwind in your project.

What does Tailwind need to run?

SKILL.md names no scripts, command-line tools or credentials: Tailwind is instructions for the agent only. Our summary lists: Node.js.

Does Tailwind access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tailwind 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 use?

Tailwind 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 use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 15k tokens, read only when the agent opens those files.

What are the alternatives to Tailwind?

Skills that share tags, products or a category with Tailwind: Shadcn Tailwind UI (LiarMTTT/TavernWeave, 148 stars), Tailwindcss (einverne/dotfiles, 121 stars), UI Styling (Ohh-889/skyroc, 795 stars) and Tailwind Theme Builder (jezweb/claude-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tailwind?

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.