Design Skills

A design skill is one Markdown file that gives your AI coding tool a complete design system. It holds the color tokens for light and dark mode, the fonts, the radius, the classes each component needs and the rules that keep screens consistent. Your assistant reads it and follows it every time it builds UI.

Browse the skills and their live previews on the Design Skills page.

Requirements

  • A Pro, Team or Enterprise plan. The live previews are open to everyone, the skills need a paid plan.
  • An API key from API Keys. It is the same key the Shadcn CLI and the MCP Server use.
  • A project set up with shadcn/ui and Tailwind CSS v4, with a components.json file.

1. Add the registry

Skills install with the regular shadcn CLI from the @shadcnuikit registry. Add the registry to the registries field of your components.json:

{
  "registries": {
    "@shadcnuikit": {
      "url": "https://shadcnuikit.com/r/{name}.json",
      "headers": {
        "Authorization": "Bearer ${REGISTRY_TOKEN}"
      }
    }
  }
}

Then add your API key to the .env file in the project root:

REGISTRY_TOKEN=your_api_key

Keep the key out of version control. You only do this once per project. If you already install kit blocks with the shadcn CLI, the registry is set up and you can skip this step.

2. Install a skill

Run one command in your project root. Replace eclipse with the skill you want: eclipse, clay, nebula, ember, monolith, verdant, stellar or crayon.

npx shadcn@latest add @shadcnuikit/eclipse-design

The command does three things:

  • Skill file: saves the design rules where your AI tool reads them.
  • Theme: writes the light and dark color tokens and the radius to globals.css.
  • Fonts: adds the skill fonts. In Next.js they go to app/layout.tsx with next/font/google. In other frameworks the CLI installs them from Fontsource.

The CLI lists every file it creates or changes before it writes them. If a command fails with a 401 error, the key is missing, wrong or expired. A 403 error means the account does not have a Pro, Team or Enterprise plan.

Each AI tool reads its instructions from a different place, so every skill comes in three versions. Pick the command for your tool below.

Claude Code

npx shadcn@latest add @shadcnuikit/eclipse-design

Claude Code loads the skill from .claude/skills whenever your request is about UI. Nothing else to do.

Cursor

npx shadcn@latest add @shadcnuikit/eclipse-design-cursor

Cursor applies the rule when the agent works on .tsx files. Nothing else to do.

Codex and other tools

npx shadcn@latest add @shadcnuikit/eclipse-design-agents

Codex reads AGENTS.md from the project root. The CLI does not edit that file, so add one line to it, or create it if it does not exist:

Follow the design system in docs/eclipse-design.md for every UI task.

For GitHub Copilot, Windsurf, Gemini CLI, Cline or Zed, point the tool's instructions to docs/eclipse-design.md, for example from .github/copilot-instructions.md or .windsurf/rules/.

What a skill contains

  • Setup: the theme CSS for globals.css and the next/font code for the fonts. The CLI applies both for you.
  • Visual language: how the skill uses color, shape, type, depth and spacing.
  • Component classes: the className values for Button, Card, Input, Badge, Tabs and smaller parts like switches, sliders and progress bars.
  • Do and don't: short rules the assistant checks before it finishes.
  • Kit blocks: the Shadcn UI Kit blocks that fit the skill, by registry name.

Switch to another skill

Keep a single design skill in a project. Two skills give your assistant conflicting rules. To switch, run the command for the new skill. It replaces the theme tokens and the fonts. Then delete the old skill file, for example .claude/skills/eclipse-design.

Without the shadcn CLI

If your project does not use the shadcn CLI, download the file directly. Sign in and use the Download SKILL.md button on the skill page, or send your API key with curl:

mkdir -p .claude/skills/eclipse-design
curl -fsSL -H "Authorization: Bearer YOUR_API_KEY" \
  https://shadcnuikit.com/design-skills/eclipse/files/SKILL.md \
  -o .claude/skills/eclipse-design/SKILL.md

Use rule.mdc for Cursor and AGENTS.md for Codex in the same address. In this case ask your assistant to apply the theme and fonts from the file, since the CLI is not doing it.

Prompts to try

  • Apply the eclipse design skill to this project.
  • Build a pricing page with the clay skill and kit blocks.
  • Restyle the settings page so it follows the nebula skill.
  • Add a dashboard overview with stat cards, a chart and a table.

Works best with the MCP server

The skill tells your assistant how things should look. The MCP Server, included in the same plans, gives it the full kit catalog to build from, including premium blocks and dashboards. Without it, your assistant installs items with the Shadcn CLI.

For general kit conventions without a visual style, see AI Skills.