# tailwind-wasp-drone

A framework specialist for Tailwind CSS v4 configuration, migration, dark mode, and container queries. Use it when a problem concerns Tailwind mechanics rather than project-specific design rules.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/web-development-tools/agents/tailwind-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/tailwind-wasp-drone

## What it does

The subagent handles CSS-first configuration, utility generation, dark mode, container queries, and Tailwind class ordering. For a v3 migration, it starts with `npx @tailwindcss/upgrade` on a clean branch, then checks for changes the tool may miss, including the `default-border-color` and `outline-none` renames.

A class- or attribute-based dark mode needs an explicit `@custom-variant dark` declaration; `.dark` alone will not activate the variant. For class sorting, the subagent recommends `prettier-plugin-tailwindcss` and checks that it loads last in Prettier’s `plugins` array.

Its scope stops at framework behavior. Project-specific token policy, Svelte component architecture, and shadcn-svelte internals belong to other subagents. Start migration from a clean branch; that is part of the prescribed process.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install web-development-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/tailwind-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/tailwind-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/tailwind-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/web-development-tools/agents/tailwind-wasp-drone.md

## When to use it
- migrate a codebase from Tailwind CSS v3 to v4
- configure `@theme` and utility generation
- fix class- or attribute-based dark mode
- adapt a component with container queries
- set up Tailwind class sorting in Prettier

## Example prompts
- Check this project for issues in its Tailwind CSS v3-to-v4 migration.
- Explain why `.dark` does not activate dark mode and inspect the `@custom-variant` setup.
- Set up Prettier to sort Tailwind classes.

## Similar
- [tailwind-css](https://affpapa.org/en/nevibecode/skills/tailwind-css.md) — skill · 3100 installs
- [tailwind-patterns](https://affpapa.org/en/nevibecode/skills/coco-research-tailwind-patterns.md) — skill · ★ 328 repo stars
- [tailwind-v4-vite](https://affpapa.org/en/nevibecode/rules/tailwind-v4-vite.md) — rule · ★ 41430 repo stars
- [tailwind-v4](https://affpapa.org/en/nevibecode/skills/mastra-ai-tailwind-v4.md) — skill · 120 installs
- [material-ui-tailwind](https://affpapa.org/en/nevibecode/skills/material-ui-tailwind.md) — skill · 383 installs
- [tailwind-design-system](https://affpapa.org/en/nevibecode/skills/giuseppe-trisciuoglio-tailwind-design-system.md) — skill · 4800 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
