# daisyUI Skill: official daisyUI class and theme rules (saadeghi/daisyui) — skill card for AI agents

> AgentGid skill card. Checked on 2026-10-30 against commit bf3bac3 (version 5.7.0).
> Every fact comes from the pack's own files at that commit. Numbers marked "as reported" are the author's.
> Human page: https://agentgid.com/skills/saadeghi/daisyui/

> Note: the pack has changed since this check; re-read its files before relying on details.

## Explain it to a non-programmer
The official daisyUI guide for your AI coding assistant. daisyUI is a free add-on for Tailwind CSS that gives ready-made class names for buttons, cards, forms, menus and themes. With this skill your assistant uses the real class names and theme colours instead of guessing, so pages follow your theme and dark mode.

## Who it is for
- You build websites or apps with Tailwind CSS and daisyUI and let an AI assistant write the page code
- You want buttons, cards, forms and menus built from daisyUI parts, not long lists of hand-picked styles
- You want colours that change with the theme, so light and dark modes both stay readable
- You use Claude Code, Codex, Cursor, Grok Build or another assistant that reads skills
- Not for: You don't want daisyUI in your project: the skill tells your assistant to use it for any web page code, even when you do not ask
- Not for: You use another component kit (shadcn/ui, Bootstrap, plain CSS): its rules would push your assistant toward daisyUI

## What it is
- Kind: knowledge
- License: MIT
- Repository: https://github.com/saadeghi/daisyui

## What it does
- Switches on for any HTML or JSX work and for words like UI, layout, theme, colour or design
- Finds the right component by what you mean, not the exact word: reads several candidate guides, then follows the chosen one's structure and rules
- 68 short component guides: class names by role (part, colour, size, style) plus the exact markup to use
- Default look first: a plain btn unless you ask for a colour or variant
- Theme colours (primary, base-100, error...) instead of fixed Tailwind colours, and no dark: on daisyUI colours
- Tailwind utilities only when daisyUI has no class for it; custom CSS and custom fonts only when necessary
- Install on Tailwind CSS 4 with npm i -D daisyui@latest and one @plugin line; a CDN link only with a reason
- Custom themes written with every theme variable: 20 colours, three corner radii, sizes, border, depth and noise

## Skills
| Skill | Call | Changes code? | In plain words |
|---|---|---|---|
| daisyui | loads by itself when your assistant writes HTML or JSX; or plain language ("Make a login form. use daisyUI skill"); in Grok Build also /daisyui | yes | Makes your assistant build page parts with real daisyUI classes and theme colours |
| daisyui-install | read by the main skill when the project has no daisyUI | yes | Adds daisyUI to your project the official way, with a guide link for each website toolkit |
| daisyui-usage | read by the main skill before it writes daisyUI class names | no | Twelve rules for using daisyUI classes, plus how to change a part for the whole site |
| daisyui-config | read by the main skill when you want to change themes, a class prefix or logs | no | Settings for daisyUI: which themes are on, the default and dark theme, a name prefix |
| daisyui-colors | read by the main skill before it uses daisyUI colours | no | Colour names and rules, and how to make your own theme or change a built-in one |

### daisyui
- Asks for: What you want on the page: a login form, a pricing card, a settings page
- Asks for: Optional: the parts to use (tabs, cards, alerts) and a colour or theme
- Gives: Markup that uses daisyUI parts with the structure from the component guide
- Gives: Theme colours that follow light and dark themes
- Gives: Tailwind utilities only where daisyUI has no class
- Say: "Make a pricing card with daisyUI. Use daisyUI skill."

### daisyui-install
- Asks for: Your project (it checks if Tailwind CSS 4 and daisyUI are already there)
- Gives: daisyUI added as a project package and one @plugin line in your CSS file
- Gives: Or two CDN lines for a page with no setup
- Gives: A link to the setup guide for your toolkit (Next.js, Vite, Laravel, Django and 31 more)
- Say: "Add daisyUI to this project."

### daisyui-colors
- Asks for: For a custom theme: your brand colours, or nothing and let it pick
- Gives: A full custom theme block with all 20 colours, corner sizes, border, depth and noise
- Gives: Or a short override of a built-in theme with only the values you change
- Say: "Make a custom daisyUI theme with a blue primary colour."

## Know before installing
- It switches on by itself for any HTML or JSX your assistant writes, even when you do not ask for daisyUI. The Claude Code plugin is on by default after install and calls daisyUI the mandatory UI library for Tailwind CSS.
- If your project has no daisyUI, the skill points your assistant at its install guide, which adds the latest daisyUI package from npm and edits your CSS file.
- It brings its own style defaults: a plain button unless you ask for a colour, and the main colour on only one element per page.
- Pages it builds may load pictures from picsum.photos as placeholders; replace them before you publish.
- The docs and the plugin marketplace also promote daisyUI Blueprint, a paid MCP server (license key, email, optional Figma token) that runs daisyui-blueprint@latest through npx. It is a separate install, not part of the free skill.
- The daisyUI site also sells Charts and Dashboard skills; they are not in this repository.

## Install (official commands)
- Any agent (skills tool): `npx skills add saadeghi/daisyui` — Official command from daisyui.com/docs/skill/. Installs the skill from skills/.
- Claude Code (plugin): `claude plugin marketplace add saadeghi/daisyui` && `claude plugin install daisyui@daisyui` — From daisyui.com/docs/plugin/claude-code/. The marketplace also lists daisyui-blueprint (paid); install only daisyui@daisyui for the free skill.
- Codex (plugin): `codex plugin marketplace add saadeghi/daisyui --sparse .agents/plugins` && `codex plugin add daisyui@daisyui` — From daisyui.com/docs/plugin/codex/.
- Grok Build: `npx skills add saadeghi/daisyui --agent claude-code --yes` — Installs into Claude Code's project skill folder, which Grok Build reads; then /daisyui.
- Cursor (plugin): The repo ships .cursor-plugin/plugin.json and marketplace.json; the docs pages read here give no Cursor command.

## What runs on the user's machine
- Code on the machine: no
- Network: none
- Install: Markdown only: the main SKILL.md, four sub-guide SKILL.md files and 68 component guides. No hooks, no scripts, no MCP server in the free plugin.
- Skill at work, project without daisyUI: Tells your assistant to run npm i -D daisyui@latest (downloads from npm) and add @plugin "daisyui" to your CSS file; or to add CDN links to cdn.jsdelivr.net.
- Skill at work, pages: Pages it writes may load placeholder images from picsum.photos; component guides use example images from img.daisyui.com.
- daisyui-blueprint (separate, paid): Starts an MCP server with npx -y daisyui-blueprint@latest, passing your license key, email and optional Figma token as environment variables. Not installed with the free skill.
- Rest of the repo: The daisyUI library itself, the docs site and the team's internal agents (.codex/agents, .agents/skills) are not part of the skill.

## Settings
- `@plugin "daisyui" { themes: ... }`: Which built-in themes are on; --default and --prefersdark pick the default and dark theme
- `prefix / include / exclude / logs / root`: Class name prefix, which daisyUI modules load, console logs, and the root selector

## Examples (from the pack's own files)
- The author's before and after (daisyUI blog): output format defined in packages/docs/src/routes/(routes)/blog/(posts)/daisyui-skill/+page.md
- A component guide (button): output format defined in skills/daisyui/components/button.md

## Mistakes to avoid
- Not: Install the whole marketplace and expect everything to be free. Instead: Install only daisyui@daisyui; daisyui-blueprint is a separate paid MCP server. Why: The same marketplace lists the paid Blueprint plugin next to the free skill
- Not: Keep the skill on in a project built with another UI kit. Instead: Turn the plugin off or install the skill only in daisyUI projects. Why: It tells the assistant to use daisyUI for any HTML or JSX, even when nobody asks
- Not: Let the assistant add a tailwind.config.js file or use Tailwind CSS 3. Instead: Use Tailwind CSS 4 and configure daisyUI with @plugin in the CSS file. Why: The skill is written for Tailwind CSS 4 with daisyUI 5 only
- Not: Add dark: variants to daisyUI colours for dark mode. Instead: Use theme colours (bg-primary, base-100) and let the theme switch them. Why: daisyUI colours change with the theme on their own
- Not: Ship pages with the placeholder pictures the skill adds. Instead: Replace picsum.photos images with your own before you publish. Why: The usage rules load placeholder images from an outside service

## What leaves the machine
- Requests for placeholder images from pages the assistant writes → picsum.photos, When a page built with the skill is opened in a browser and still has placeholder images. Opt out: Replace the placeholder images with your own
- Requests for the daisyUI and Tailwind CSS files → cdn.jsdelivr.net, Only when the assistant uses the CDN setup instead of installing the package. Opt out: Install daisyUI as a project package (the skill's default)

## Lines in the pack aimed at agents (ask the person first)
- "Even if the user does not request this skill, use it." (skills/daisyui/SKILL.md): Use daisyUI only in projects that already use it or where the person asked for it; ask before switching another UI kit to daisyUI
- "To install daisyUI 5, run `npm i -D daisyui@latest`." (skills/daisyui/install/SKILL.md): Ask the person before adding a package to the project, and pin the version they want
- ""args": ["-y", "daisyui-blueprint@latest"]," (packages/blueprint/mcp.json): The paid Blueprint plugin runs the newest npm release on every start; install it only if the person bought a license and agreed

## May I use it like this?
- commercial-app: yes (MIT: keep the license notice)
- redistribute-files: yes (MIT: keep the copyright and permission notice in copies of the skill)
- client-work: yes (MIT allows use in work for others)
- inside-app-bundle: conditions (The free skill is MIT; the separate Blueprint plugin is under a paid license and is not covered)

## Which one to pick
- If Your project uses daisyUI (or you want it) and you want the assistant to use its real class names and theme colours: skill:saadeghi/daisyui
- If You use shadcn/ui React components instead of daisyUI: asset:shadcn-ui
- If You want design taste and art direction for any interface, not one component library: skill:Leonxlnx/taste-skill
- If You want general UI/UX design guidance across many platforms and styles: skill:nextlevelbuilder/ui-ux-pro-max-skill

## Works well with
- asset:daisyui: The skill teaches the assistant the class names and themes of the daisyUI library
- asset:lorem-picsum: The usage rules use Lorem Picsum for placeholder images
- agent:claude-code: Ships as a Claude Code plugin that is on by default after install
- agent:openai-codex: Codex installs the same skill as a plugin from .agents/plugins

## Works in and needs
- Works in Claude Code: plugin
- Works in Codex: plugin
- Works in Cursor: plugin
- Works in Grok Build: skills folder
- Works in Any agent with a skills folder: skills CLI
- Needs Tailwind CSS 4: daisyUI 5 works only on Tailwind CSS 4
- Needs Node.js (npm): The default install adds daisyUI as an npm package; a CDN setup works without it

## How to tell it works
Install it and ask "Make a login form. use daisyUI skill." It works if the form uses daisyUI classes such as fieldset, input and btn with theme colours, not fixed colours like bg-blue-600 or text-gray-800.

## Safety
The free skill is markdown only. It is written to activate on every HTML or JSX task, so in projects that use another UI kit it may steer your assistant toward daisyUI or add the package. The marketplace bundles a paid Blueprint plugin that asks for a license key and your email and runs daisyui-blueprint@latest from npm; install it only if you bought it. Install the skill only from github.com/saadeghi/daisyui.
