К основному содержанию
скилл CX Codex

token-mapping — скилл для Claude Code: разбор токенов

Скилл token-mapping для Claude Code сопоставляет жёстко заданные значения стилей с токенами проекта. Запускается для аудита страницы, файла или diff перед миграцией на токены.

MIT 586 установок ★ 616 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add arla6ka/design.how --skill token-mapping -a claude-code
Открыть на GitHub

Что делает token-mapping

Скилл находит в проекте список дизайн-токенов и сравнивает с ним значения из выбранной страницы, файла или diff. В отчёте указывает файлы, строки, свойства и назначение значений, прослеживает алиасы в каждом режиме и отмечает расхождения между источниками.

Сопоставление учитывает назначение токена и его значение. Результаты делятся на точные совпадения, семантические совпадения в пределах допуска, неоднозначные варианты и пробелы. Значения нормализуются кодом: длины — до px, цвета — до OKLCH с delta E OK. Если пробелы составляют больше 30% строк и их не меньше 12, отчёт получает статус not actionable (gap threshold). Скилл работает только на чтение: репозиторий не меняется.

Какие задачи решает

  • сопоставить жёстко заданные цвета с токенами проекта
  • найти значения стилей на странице или в diff
  • выявить неоднозначные совпадения и пробелы в списке токенов
  • подготовить отчёт для миграции на дизайн-токены

Примеры запросов агенту

  • Проверь токены на странице настроек.
  • Сопоставь жёстко заданные цвета в этом файле с токенами проекта.
  • Проведи аудит токенов для текущего diff.

Как установить token-mapping

1Через Skills CLI (Vercel)

npx skills add arla6ka/design.how --skill token-mapping -a claude-code

2Вручную: положить файлы

~/.claude/skills/token-mapping/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/token-mapping/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о token-mapping

Как установить token-mapping в Claude Code?

Выполни npx skills add arla6ka/design.how --skill token-mapping -a claude-code. Файл скилла находится по пути ~/.claude/skills/token-mapping/SKILL.md.

Что делает token-mapping?

Скилл сопоставляет значения стилей в коде с существующими токенами проекта и формирует отчёт с совпадениями, неоднозначностями и пробелами. Он не меняет файлы.

Как token-mapping определяет совпадение токена?

Сначала учитывается назначение токена, затем значение. Точные и семантические совпадения разделяются; если подходят несколько токенов, скилл перечисляет кандидатов.

Исходный текст

SKILL.md · MIT
---
name: token-mapping
description: Use to report how hardcoded style values on a page, file or diff map onto a project's existing design tokens, such as "are we using our tokens here", "which hardcoded colors map to which tokens", a token audit or planning a token migration. It never edits. Replacing the values is build-design-system.
metadata:
  summary: Maps values to tokens
---

# Token mapping

A read-only report that lands raw values (hex, px, shadows) on a token list someone else owns. Classes, normalising and tolerances are in `references/mapping-rules.md`. "Check the tokens on the settings page" is enough of an ask. Find the values and the list yourself.

## Steps

1. **Find the list.** Token files, theme entries, custom properties on `:root`, a component library's variable pairs. A framework's default theme is not the team's list, and neither is a public system's (Geist's names never stand in for the team's). Record its name, location and how you read it. If a read fails, say so and stop. Never fill a list from memory.
2. **Find the values.** What the person named, else the branch diff, else the product code. Record each with its file, line, property and job.
3. **Resolve.** Follow every alias to its final value in each mode. Write down every disagreement between two sources.
4. **Normalise** both sides (lengths to px, colours to OKLCH compared by delta E OK) with code, never by eye.
5. **Classify** each row once per mode. Purpose first, then value.
   - Exact: the token's stated job covers the row and the values match.
   - Semantic: the job covers it and the value is inside tolerance. State the difference in numbers.
   - Ambiguous: two or more tokens fit and nothing picks one. Name every candidate.
   - Gap: no token's job covers it, or the only fitting token is out of tolerance. A gap never gets a new name.
6. **Count and close.** When gaps are over 30% of rows and number 12 or more, the list is usually the wrong one. Say so, still deliver the table, and lead with `Status: not actionable (gap threshold)`.

## Report

Summary, Mapping, Do not use (a token whose value matches but whose job differs), Ambiguous, Gaps, For a person to decide, Source. Last line `Coverage:` with what was scanned and what was not. Run on its own, the chat reply gives the answer with its numbers and one prompt the person can paste to take the next step.

## Rules

- A match on value before purpose is wrong. Wrong: `#6b7280` mapped to `color.border.default` because the hex is equal. Right: it is text, so the candidates are text tokens, and the border token goes in Do not use.
- A semantic token wins over the primitive it aliases. Map to a primitive only when no semantic token covers the job, and say so.
- A palette class (`text-gray-500`) names a value and no job. It gets a row, counted apart from raw values.
- Anything inferred rather than read, such as a job taken from a class name, is marked inferred.
- Counts carry their unit: occurrences, lines or mapping rows.

## Stops

Stop and report on these only. No list exists. One name has two values in the same mode. Two sources disagree and no project rule says which wins (report both). Return what stopped it, the groundwork so far, and the shortest message that unblocks it, such as "Paste `tokens.json` or give its path."

## Done

Every row has a job, a class and a reason. Every ambiguous row names two or more candidates. Nothing in the repo changed (`git status` is the same before and after). The last line reads `Coverage:`.

© arla6ka · MIT · arla6ka/design.how

Похожие скиллы

Все скиллы по теме «Дизайн» →
design-token Owl-Listener Скилл design-token для Claude Code и Codex, который описывает архитектуру дизайн-токенов: категории цвета, отступов, типографики и теней, уровни абстракции и правила именования. Запускается при закладке слоя токенов с нуля. CX Codex +1 2 600установок qt-figma-token-extraction qt-ai-skills Скилл qt-figma-token-extraction достаёт переменные, текстовые стили и токены из файла Figma и превращает их в design-tokens.json и готовые QML-синглтоны с общим Theme. CX Codex +1 533установок token-normalizer ShuaiMXu Скилл token-normalizer для Claude Code превращает повторяющиеся визуальные значения в предложения семантических токенов. Он сохраняет существующие имена и отмечает спорные случаи для проверки. CX Codex +1 ★ 529звёзд репо image-to-code plugin87 Скилл image-to-code для Claude Code превращает скриншот, макет или референс в код интерфейса с общей темой дизайн-токенов. Запускается, когда нужно воссоздать UI по изображению. CX Codex +1 816установок design-system akillness Скилл design-system задаёт общие правила интерфейса, дизайн-токены и архитектуру компонентов до вёрстки отдельных экранов. Помогает связать лендинги и дашборды в единую систему. CX Codex +1 490установок design-system-starter davila7 Скилл design-system-starter помогает заложить дизайн-систему в проекте: генерирует дизайн-токены в JSON, структуру React-компонентов и проверяет контрастность по WCAG 2.1 AA. CX Codex +1 186установок

Из того же набора6

build-design-system Скилл build-design-system для Claude Code собирает систему дизайна из интерфейса приложения. Запускается для выделения токенов, доработки компонентов или начала такой системы. CX Codex +1 603установок design-system-boss Скилл design-system-boss для Claude Code координирует работу с дизайн-системами в приложениях с готовым пользовательским интерфейсом. CX Codex +1 583установок component-docs Скилл component-docs для Claude Code пишет документацию одного UI-компонента по коду, stories и реальным вызовам. Запускается по просьбам документировать компонент или его состояния. CX Codex +1 582установок migrate-design-system Скилл migrate-design-system для Claude Code переносит кодовую базу на готовую дизайн-систему через пошаговый аудит, замеры базового состояния и проверку экранов отдельным верификатором. CX Codex +1 577установок ui-review Скилл ui-review для Claude Code, проводящий ревью интерфейсов, прототипов и текущих сборок. Выполняет проверку доступности, находит ошибки в верстке и ранжирует их по критичности. CX Codex +1 564установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой