tailwind-wasp-drone — Claude Code subagent for Tailwind CSS v4
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.
AGPL-3.0-or-later ★ 96 updated 2026-10-18
/plugin marketplace add legioncodeinc/vibe-coding-tools
/plugin install web-development-tools@wasp-nestWhat tailwind-wasp-drone 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.
What it helps with
- migrate a codebase from Tailwind CSS v3 to v4
- configure
@themeand utility generation - fix class- or attribute-based dark mode
- adapt a component with container queries
- set up Tailwind class sorting in Prettier
Example prompts for the agent
- Check this project for issues in its Tailwind CSS v3-to-v4 migration.
- Explain why
.darkdoes not activate dark mode and inspect the@custom-variantsetup. - Set up Prettier to sort Tailwind classes.
How to install tailwind-wasp-drone
1Plugin marketplace
/plugin marketplace add legioncodeinc/vibe-coding-tools/plugin install web-development-tools@wasp-nest2Manually: put the files in place
.claude/agents/tailwind-wasp-drone.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/tailwind-wasp-drone.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/tailwind-wasp-drone.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about tailwind-wasp-drone
How do I install tailwind-wasp-drone in Claude Code?
Run /plugin marketplace add legioncodeinc/vibe-coding-tools, then /plugin install web-development-tools@wasp-nest. The agent file is .claude/agents/tailwind-wasp-drone.md.
What does tailwind-wasp-drone do?
It handles Tailwind CSS v4 framework questions, including CSS configuration, the Vite plugin, migration, dark mode, container queries, and class ordering.
Why doesn’t the .dark class switch on dark mode?
Class-based dark mode requires an explicit @custom-variant dark declaration. The class by itself does not activate the variant.