Use with AI / Design skills

Design skills

A design skill teaches your AI agent one design system: which look to build in, where the exact values live and which rules to check. Here is what is inside one and how to install it in Claude Code.

4 min readClaude Code, Cursor, Claude appsexample: Lagoonupdated Oct 17, 2026

What a design skill is

A skill is a folder an AI agent loads when a task calls for it. At its heart is a SKILL.md file: a name and a one-line description in YAML front matter, then the instructions. The agent reads only the descriptions up front and opens the rest when you ask for something that matches, so a skill costs almost nothing until it is needed.

A design skill is a skill for UI work. It tells the agent which look to build in, which file holds the exact values, which component to reach for and which rules to check before it hands back a screen. Ours work in Claude Code, Cursor and the Claude apps.

What is inside ours

Each style ships its skill as a folder with the instructions and the references they point to:

skill folder
1skill/vibecoded-lagoon/
2├─ SKILL.md
3└─ references/
4 ├─ DESIGN.md
5 ├─ theme.css
6 └─ illustrations/

And this is how the SKILL.md of Lagoon, the free style, begins:

SKILL.md
1---
2name: vibecoded-lagoon
3description: Lagoon design system for business management,
4 booking, HR and public-service tools: roomy controls, a deep
5 teal accent, pill buttons, clear Inter type, shadcn and Tailwind
6 tokens.
7---
8
9# Lagoon design system
10
11Use this skill when the user builds business management
12and back-office tools ... or asks for the Lagoon style.
13
14## Rules
15
16- Use only the semantic utilities from DESIGN.md (bg-primary, ...
17- Do use the deep teal for the primary action in light mode; ...
18- Do keep the roomy control heights; Lagoon is designed for ...
19...

The description decides when the skill loads, so it names the kinds of products the style is for. The rules are written to be checked: semantic utilities only, one primary button per view, an empty state with a next step, AA contrast in both modes.

Install it in Claude Code

Claude Code loads skills from the .claude/skills folder of your project, and from ~/.claude/skills when you want them in every project. Copy the folder in:

terminal
1mkdir -p .claude/skills
2cp -r vibecoded-lagoon/skill/vibecoded-lagoon .claude/skills/

Point every session at DESIGN.md with one line in CLAUDE.md, then ask for a screen and name the skill the first time:

CLAUDE.md
1The UI follows vibecoded-lagoon/DESIGN.md (Vibecoded Design, Lagoon style).
claude
1> Build an HR dashboard with a team calendar and today's
2 leave requests. Use the vibecoded-lagoon skill and follow
3 vibecoded-lagoon/DESIGN.md for every component.
noteThe theme goes in once too: import theme.css right after Tailwind in your global stylesheet. The Claude Code guide walks through every step.

General design skills and style skills

General skills, such as the open-source frontend-design skill, teach an agent good taste in general: avoid generic layouts, pick a clear type hierarchy, keep spacing consistent. They help any project, and they leave the actual look up to the agent.

A style skill decides the look. It names the exact colors, fonts, radius, motifs and components, so two screens built a week apart still look like one product. The two work well together: the general skill keeps the agent thoughtful, and the style skill keeps it consistent.

Light and full skills

Style Pack · $39The light skill: the character of the style, the setup, the rules and the motifs, with DESIGN.md and the theme as references.
Full Design System · $129The full skill: everything in the light one, plus page recipes and UX rules for landing, pricing, sign-in, dashboard and settings pages.
Kits and UX PacksTheir own skills for whole products and flows, from an AI SaaS app to a paywall, in whichever style you own.

16 design skills, one per style

Every style comes with its skill. Pick the one that matches what you build:

Questions

What is a Claude design skill?

A skill folder with a SKILL.md that Claude loads when you ask for UI. It holds the rules of a design system and points at the files with the exact values.

Where does Claude Code look for skills?

In .claude/skills inside your project, and in ~/.claude/skills for skills you want in every project. Each skill is its own folder with a SKILL.md at the top.

Do design skills work outside Claude Code?

Ours work in Claude Code, Cursor and the Claude apps. In tools without skills, give the agent DESIGN.md and the theme directly.

How is a skill different from DESIGN.md?

DESIGN.md describes the design system. The skill tells the agent when to use it and how: which file to read, which component to pick and which rules to check.

Is there a free design skill?

Yes. The Lagoon Style Pack, with its skill, DESIGN.md, theme and tokens, is free for an email address.

Install a design skill in two minutes

Start with Lagoon for free, or pick the style that fits your product.

Was this page helpful?