unocss — Claude Code skill: what it does, how to install
A skill that gives the agent reference material on UnoCSS configuration, rules, shortcuts and presets. Useful when setting up UnoCSS or reusing Tailwind knowledge in it.
npx skills add antfu/skills --skill unocss -a claude-codeWhat unocss does
The skill treats UnoCSS as an atomic CSS engine with no built-in utilities of its own: everything comes from presets, and the syntax is a superset of Tailwind CSS, so basic Tailwind knowledge carries over. Topics covered include configuration, static and dynamic rules, shortcuts, theming, variants such as hover: and dark:, how UnoCSS extracts classes from source, safelist/blocklist, layers and preflights, and processors such as Lightning CSS.
It also documents presets — Wind3, Wind4, Mini, Icons, Attributify, Typography, Web Fonts, Tagify, Rem to Px — plus transformers for variant grouping, @apply/@screen/theme() directives, class compilation, and attributify support in JSX. Integration notes cover Vite and Nuxt setups.
Before writing UnoCSS code, the agent is told to check the project root for uno.config.* or unocss.config.* to see which presets and rules are already in place. If the setup is unclear, it's steered away from attributify mode and other advanced features toward plain class usage.
What it helps with
- set up a UnoCSS config with the right presets
- write static and dynamic utility rules
- combine utilities into a shortcut
- wire up icons via Iconify or attributify mode
- configure a Vite or Nuxt build with UnoCSS
Example prompts for the agent
- set up UnoCSS in this project with the Wind3 preset and icons
- add a UnoCSS shortcut for the card component
- check uno.config.ts and suggest which presets to enable
How to install unocss
1Skills CLI (Vercel)
npx skills add antfu/skills --skill unocss -a claude-code2Manually: put the files in place
~/.claude/skills/unocss/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/unocss/
1Skills CLI (Vercel)
npx skills add antfu/skills --skill unocss -a codex2Manually: put the files in place
.agents/skills/unocss/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add antfu/skills --skill unocss -a cursor2Manually: put the files in place
.cursor/skills/unocss/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install antfu/skills unocss2Manually: put the files in place
.github/skills/unocss/SKILL.md1Skills CLI (Vercel)
npx skills add antfu/skills --skill unocss -a gemini-cli2Platform CLI
gemini skills install https://github.com/antfu/skills --path skills/unocssManually: put the files in place
.devin/skills/unocss/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add antfu/skills --skill unocss -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set7
The whole set →Similar
Questions about unocss
How to install unocss in Claude Code?
Run npx skills add antfu/skills --skill unocss -a claude-code — the skill lands in ~/.claude/skills/unocss/SKILL.md.
What does the unocss skill do?
It gives the agent reference material on UnoCSS configuration, rules, presets and transformers so it writes correct utilities and sets up the build without guessing the syntax.
Does it require knowing Tailwind CSS?
UnoCSS is described as a superset of Tailwind CSS, so basic utility syntax carries over directly, while the skill adds coverage of presets, shortcuts and theming that Tailwind doesn't have.
Source text
SKILL.md · MIT
--- name: unocss description: UnoCSS instant atomic CSS engine, superset of Tailwind CSS. Use when configuring UnoCSS, writing utility rules, shortcuts, or working with presets like Wind, Icons, Attributify. metadata: author: Anthony Fu version: "2026.9.25" source: Generated from https://github.com/unocss/unocss, scripts located at https://github.com/antfu/skills --- UnoCSS is an instant atomic CSS engine designed to be flexible and extensible. The core is un-opinionated - all CSS utilities are provided via presets. It's a superset of Tailwind CSS, so you can reuse your Tailwind knowledge for basic syntax usage. **Important:** Before writing UnoCSS code, agents should check for `uno.config.*` or `unocss.config.*` files in the project root to understand what presets, rules, and shortcuts are available. If the project setup is unclear, avoid using attributify mode and other advanced features - stick to basic `class` usage. > The skill is based on UnoCSS v66.10.5, generated at 2026-09-25. ## Core | Topic | Description | Reference | |-------|-------------|-----------| | Configuration | Config file setup and all configuration options | [core-config](references/core-config.md) | | Rules | Static and dynamic rules for generating CSS utilities | [core-rules](references/core-rules.md) | | Shortcuts | Combine multiple rules into single shorthands | [core-shortcuts](references/core-shortcuts.md) | | Theme | Theming system for colors, breakpoints, and design tokens | [core-theme](references/core-theme.md) | | Variants | Apply variations like hover:, dark:, responsive to rules | [core-variants](references/core-variants.md) | | Extracting | How UnoCSS extracts utilities from source code | [core-extracting](references/core-extracting.md) | | Safelist & Blocklist | Force include or exclude specific utilities | [core-safelist](references/core-safelist.md) | | Layers & Preflights | CSS layer ordering and raw CSS injection | [core-layers](references/core-layers.md) | | Processors | Transform generated CSS layers (incl. Lightning CSS) | [core-processors](references/core-processors.md) | ## Presets ### Main Presets | Topic | Description | Reference | |-------|-------------|-----------| | Preset Wind3 | Tailwind CSS v3 / Windi CSS compatible preset (most common) | [preset-wind3](references/preset-wind3.md) | | Preset Wind4 | Tailwind CSS v4 compatible preset with modern CSS features | [preset-wind4](references/preset-wind4.md) | | Preset Mini | Minimal preset with essential utilities for custom builds | [preset-mini](references/preset-mini.md) | ### Feature Presets | Topic | Description | Reference | |-------|-------------|-----------| | Preset Icons | Pure CSS icons using Iconify with any icon set | [preset-icons](references/preset-icons.md) | | Preset Attributify | Group utilities in HTML attributes instead of class | [preset-attributify](references/preset-attributify.md) | | Preset Typography | Prose classes for typographic defaults | [preset-typography](references/preset-typography.md) | | Preset Web Fonts | Easy Google Fonts and other web fonts integration | [preset-web-fonts](references/preset-web-fonts.md) | | Preset Tagify | Use utilities as HTML tag names | [preset-tagify](references/preset-tagify.md) | | Preset Rem to Px | Convert rem units to px for utilities | [preset-rem-to-px](references/preset-rem-to-px.md) | ## Transformers | Topic | Description | Reference | |-------|-------------|-----------| | Variant Group | Shorthand for grouping utilities with common prefixes | [transformer-variant-group](references/transformer-variant-group.md) | | Directives | CSS directives: @apply, @screen, theme(), icon() | [transformer-directives](references/transformer-directives.md) | | Compile Class | Compile multiple classes into one hashed class | [transformer-compile-class](references/transformer-compile-class.md) | | Attributify JSX | Support valueless attributify in JSX/TSX | [transformer-attributify-jsx](references/transformer-attributify-jsx.md) | ## Integrations | Topic | Description | Reference | |-------|-------------|-----------| | Vite Integration | Setting up UnoCSS with Vite and framework-specific tips | [integrations-vite](references/integrations-vite.md) | | Nuxt Integration | UnoCSS module for Nuxt applications | [integrations-nuxt](references/integrations-nuxt.md) |
© Anthony Fu · MIT · antfu/skills