skills/unocss/SKILL.md
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.
npx skillsauth add rockcookies/skills unocssInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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 66.x, generated at 2026-01-28.
| Topic | Description | Reference | |-------|-------------|-----------| | Configuration | Config file setup and all configuration options | core-config | | Rules | Static and dynamic rules for generating CSS utilities | core-rules | | Shortcuts | Combine multiple rules into single shorthands | core-shortcuts | | Theme | Theming system for colors, breakpoints, and design tokens | core-theme | | Variants | Apply variations like hover:, dark:, responsive to rules | core-variants | | Extracting | How UnoCSS extracts utilities from source code | core-extracting | | Safelist & Blocklist | Force include or exclude specific utilities | core-safelist | | Layers & Preflights | CSS layer ordering and raw CSS injection | core-layers |
| Topic | Description | Reference | |-------|-------------|-----------| | Preset Wind3 | Tailwind CSS v3 / Windi CSS compatible preset (most common) | preset-wind3 | | Preset Wind4 | Tailwind CSS v4 compatible preset with modern CSS features | preset-wind4 | | Preset Mini | Minimal preset with essential utilities for custom builds | preset-mini |
| Topic | Description | Reference | |-------|-------------|-----------| | Preset Icons | Pure CSS icons using Iconify with any icon set | preset-icons | | Preset Attributify | Group utilities in HTML attributes instead of class | preset-attributify | | Preset Typography | Prose classes for typographic defaults | preset-typography | | Preset Web Fonts | Easy Google Fonts and other web fonts integration | preset-web-fonts | | Preset Tagify | Use utilities as HTML tag names | preset-tagify | | Preset Rem to Px | Convert rem units to px for utilities | preset-rem-to-px |
| Topic | Description | Reference | |-------|-------------|-----------| | Variant Group | Shorthand for grouping utilities with common prefixes | transformer-variant-group | | Directives | CSS directives: @apply, @screen, theme(), icon() | transformer-directives | | Compile Class | Compile multiple classes into one hashed class | transformer-compile-class | | Attributify JSX | Support valueless attributify in JSX/TSX | transformer-attributify-jsx |
| Topic | Description | Reference | |-------|-------------|-----------| | Vite Integration | Setting up UnoCSS with Vite and framework-specific tips | integrations-vite | | Nuxt Integration | UnoCSS module for Nuxt applications | integrations-nuxt |
development
Vue 3 debugging and error handling for runtime errors, warnings, async failures, and SSR/hydration issues. Use when diagnosing or fixing Vue issues.
development
MUST be used for Vue.js tasks. Strongly recommends Composition API with `<script setup>` and TypeScript as the standard approach. Covers Vue 3, SSR, Volar, vue-tsc. Load for any Vue, .vue files, Vue Router, Pinia, or Vite with Vue work. ALWAYS use Composition API unless the project explicitly requires Options API.
development
GORM Gen 类型安全 DAO 代码生成,基于 github.com/rockcookies/go-gen(rockcookies fork)。涵盖代码生成配置、模型生成、查询构建、增删改查、关联关系、动态 SQL 注解、事务处理、datatypes 自定义字段类型(JSON/JSONMap/JSONSlice/JSONType/Date/UUID)、soft_delete 软删除插件(unix 时间戳/flag 模式),以及 fork 专有功能:Tmpl 运行时模板覆写(18 个模板)、Unsafe 底层方法(UnsafeSetDB/Alias/ModelType/TableName)、IGenericsDo[T,E] 泛型接口。使用时机:需要从数据库生成 DAO 代码(GenerateModel/GenerateModelAs)、编写 DAL 查询(DO 链式调用、DaoScope、事务、关联加载)、配置生成器(gen.Config、ModelOpt、FieldGORMTag、FieldModify、FieldType、Tmpl 自定义模板)、使用 datatypes(JSONMap、JSONSlice、JSONQuery、JSONSet)或 soft_delete(DeletedAt、softDelete:milli、deleteOpts)时使用本技能。当用户消息中包含以下任一关键词(go-gen、gorm-gen、GenerateModelAs、ModelOpt、FieldGORMTag、FieldModify、DaoScope、LoadOneToMany、LoadManyToMany、IGenericsDo、UnsafeSetDB、datatypes、JSONMap、JSONSlice、JSONQuery、soft_delete、softDelete、DeletedAt),或用户明确请求 GORM Gen 代码生成/DAO 编写时触发本技能。
development
轻量级 Go HTTP 客户端库,基于 github.com/rockcookies/go-fetch(零外部依赖)。涵盖 Dispatcher 初始化与中间件、Request 链式构建(RequestFunc 与 Middleware 分层)、Response 解码(JSON/XML/流)、请求体编码(JSON/XML/Form/Multipart/BodyGet)、URL 参数(PrepareURLMiddleware/URLOptions)、Header/Cookie 管理(ApplyHeader/ApplyCookie 与 Context)、中间件组合(Dispatcher/Request/Do 三层)、HTTP 交换日志(dump.New/dump.Transport/过滤器/WithRequestRedactor/WithResponseRedactor/SlogWriter)。使用时机:需要发起 HTTP 请求(GET/POST/PUT/PATCH/DELETE,均需 context.Context)、上传文件(Multipart/GetReader)、配置全局认证头(dispatcher.Use)、记录 HTTP 交换日志(dump.New、WithFilter、DefaultRedactor)、构建可复用的请求基础(Request.Clone)时使用本技能。当用户消息中包含以下任一关键词(go-fetch、NewDispatcher、NewDispatcherWithTransport、RequestFunc、PreFuncs、UseFuncs、BodyGet、MultipartField、dump.New、WithFilter、WithRequestRedactor、WithResponseRedactor、DefaultRedactor、DumpOptions、SlogWriter、URLOptions、PrepareURLMiddleware、PathParams、SetURLOptions、WithURLOptions、ApplyHeader、SetHeaderOptions、WithHeaderOptions、ApplyCookie、SetCookieOptions、WithCookieOptions、HandlerFunc、fetch.Handler、fetch.Middleware、dispatcher.Use、resp.Close、resp.JSON、resp.XML),或用户明确请求 go-fetch HTTP 客户端用法时触发本技能。