refactoring-ui-skill README

The project's README from github.com/s0xDk/refactoring-ui-skill. As one markdown file: README.md.

Refactoring UI (Claude Code skill)

A Claude Code skill that teaches Claude the concrete, mechanical rules from the book Refactoring UI by Adam Wathan and Steve Schoger — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light.

Every rule and CSS value in this skill was cross-checked page-by-page against the book. It's not a summary — it's the book's decisions, made once, ready to apply.

What it does

Load this skill and Claude will, when styling or reviewing UI:

It does not include the book itself — see Credits.

Repo structure

SKILL.md                 the skill: systems, procedure, hierarchy, hard rules
references/
  systems.md              building a color palette from scratch (HSL, saturation, hue rotation)
  diagnose.md              symptom -> fix table, for improving existing UI
  techniques.md            depth/light simulation, typefaces, grids, images
assets/
  tokens.css               a complete, contrast-verified starter token set

Installation

Claude Code loads skills from a folder containing a SKILL.md. Clone this repo into one of the skill directories below — use the folder name refactoring-ui so it matches the skill's declared name.

Personal skill (available in every project)

git clone https://github.com/<you>/refactoring-ui-skill.git ~/.claude/skills/refactoring-ui

Project skill (checked into a specific repo, shared with your team)

git clone https://github.com/<you>/refactoring-ui-skill.git .claude/skills/refactoring-ui

(Or add it as a git submodule at that path if you want to track updates.)

Restart Claude Code (or start a new session) after installing so it picks up the new skill.

Usage

The skill activates automatically whenever Claude is building or styling UI, picking font sizes/spacing/colors/shadows, designing a palette or design tokens, or when you say a UI "looks off", "looks amateur", or "feels cluttered/plain/unfinished." You can also invoke it explicitly:

/refactoring-ui make this dashboard look less amateur

Credits

All design rules and reasoning are drawn from Refactoring UI by Adam Wathan and Steve Schoger. This repo does not include the book's text or images — only original notes and CSS derived from its concepts. If you find this useful, buy the book: https://www.refactoringui.com/

License

MIT for the contents of this repo (see LICENSE). Does not extend to the book itself.

refactoring-ui-skill (s0xDk/refactoring-ui-skill)

Searching Database…

Что это такое?Скилл для Claude Code, который учит Claude конкретным механическим правилам дизайна из книги «Refactoring UI» Адама Ватана и Стива Шогера — фиксированные шкалы отступов, шрифтов, цветов и теней, иерархия через насыщенность и цвет, глубина через имитированный свет, — чтобы Claude применял их при построении или починке интерфейсов.
Это дизайн-система или файл скилла для Claude Code?Это скилл Claude Code: папка с файлом SKILL.md, который загружает Claude, а не CSS-библиотека или набор компонентов для импорта в приложение.
Нужно ли что-то ещё помимо Claude Code?Только сам Claude Code — ни API-ключей, ни инструментов сборки, ни дополнительных зависимостей не упоминается; это чисто markdown-файл скилла.
Включает ли это само содержимое книги?Нет — здесь только собственные заметки и CSS-значения, выведенные из идей книги, а не её текст или изображения, так что для полного контекста всё ещё нужна сама книга.
Когда скилл включается во время сессии?Он активируется автоматически, когда Claude создаёт или оформляет UI — подбирает размеры шрифтов, отступы, цвета, тени, разрабатывает палитру или токены, — или когда вы говорите, что UI выглядит «странно», «по-любительски» или «захламлённо/просто/недоделанно». Его можно вызвать и явно.
Какие проблемы он умеет диагностировать?Он превращает расплывчатые замечания вроде «выглядит странно» или «выглядит дёшево» в конкретные механические исправления, охватывающие шкалы отступов, типографическую иерархию, цвет, тени, глубину и типовые формы компонентов.
Почему бы просто не прочитать книгу самому?Автор сверил каждое правило и CSS-значение с книгой постранично, чтобы Claude применял решения книги напрямую и последовательно, а не вам приходилось каждый раз вручную переводить текстовые советы в код.
Можно ли держать скилл актуальным при изменениях репозитория?Да, вместо обычного клона можно добавить репозиторий как git-сабмодуль по пути скилла, чтобы отслеживать будущие обновления.
Creator
s0xDk
Size
<0.1 MB
Stars
642
Updated
CommitAug 26
Age
1mo
Commits · 90 Days