# The dsui skill

> How to add the skill that makes AI tools such as Claude Code use dsui by its rules.

- URL: https://dsui.vercel.app/en/docs/skill

## What the skill is

The dsui skill is a set of instructions that tells an AI coding tool (Claude Code and others) **how to build screens with dsui: the order of work and the rules**. With the skill, the AI follows the same steps every time: find an item, read it, install it, compose it by the rules, and check the result. It does not replace the component source; you still get that through [Installation](/en/docs/installation).

The skill covers:

- how to find items (`llms.txt`, the MCP `search_items` tool) and how to install them
- tokens only, checking light and dark, themes
- the rules for copy tone (Korean haeyo style), the splash screen, floating components, input fields and shadow colour
- one sound per action (`playUiSound`), motion tokens (`motionTokens`), reduced motion, IME composition
- a checklist before you finish

## Files

| File | What it holds |
| --- | --- |
| `SKILL.md` | When to use it, the order of work, a summary of the rules |
| `references/install.md` | Installing, where files go, the shared base, MCP tools |
| `references/tokens.md` | Colour, radius, shadow and type tokens, themes and dark mode |
| `references/experience.md` | Copy tone, splash, floating components, input fields, shadow colour |
| `references/sound-and-motion.md` | The 11 sound roles, motion tokens, reduced motion, IME |
| `references/components.md` | Picking items, composing them, common mistakes |
| `references/checklist.md` | A checklist before you finish |

Every file is available as Markdown: `https://dsui.vercel.app/skill/SKILL.md` and `https://dsui.vercel.app/skill/references/<name>.md`.

## Add it to your project

Download the files into `.claude/skills/dsui/` in your project. To use it in every project on your computer, use `~/.claude/skills/dsui/` instead.

```bash
base=https://dsui.vercel.app/skill
dir=.claude/skills/dsui
mkdir -p $dir/references
curl -fsSL $base/SKILL.md -o $dir/SKILL.md
for f in install tokens experience sound-and-motion components checklist; do
  curl -fsSL $base/references/$f.md -o $dir/references/$f.md
done
```

Open a new conversation and the AI will find the `dsui` skill. It loads on its own when you ask it to build or change a screen with dsui, and you can call it with `/`. If you have a copy of the repository, you can also put its `skills/dsui/` folder into `.claude/skills/`.

## Use it with the MCP server

The skill tells the AI **how to use** dsui, and the [MCP server](/en/docs/ai) tells it **what exists**. Together, the AI finds items with `search_items`, reads their source with `get_item`, and composes them by the skill's rules. The MCP server's `get_skill` tool also returns the skill, so an AI can fetch it when it needs it without you downloading the files. Without MCP the skill still works by reading `llms.txt` and the item Markdown addresses.

## Keeping it current

When the rules change, the skill changes. Run the commands above again to overwrite the files with the latest. The [Changelog](/en/docs/changelog) shows which versions changed the skill. The skill text is written in Korean.