Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Analiza

token-mapping

/token-mapping

Raportuje, które zakodowane na stałe wartości stylu odpowiadają tokenom projektu, bez zmiany plików.

Repozytorium
design.how ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Raportuje, które zakodowane na stałe wartości stylu odpowiadają tokenom projektu, bez zmiany plików.

Wyzwalacze z opisu

s existing design tokens, such aswhich hardcoded colors map to which tokens
Oryginalny opis (EN)

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.

Jak działa

  1. Steps
  2. Report
  3. Rules
  4. Stops
  5. Done
Sekcje z nagłówków SKILL.md, w oryginale · 38 linii, 556 słów
Podgląd SKILL.md
---
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.
---

# 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:`.
Pliki w paczce (2)
  • SKILL.md 3 KB
  • references/mapping-rules.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie token-mapping.

Migawka bazy z 13.11.2026 · wersja paczki ee698ddd44d4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100dh-token-mapping
    Raportuje, jak zahardkodowane wartości stylu na stronie lub w diffie odpowiadają istniejącym tokenom projektu, bez edytowania kodu.
  • 100token-compliance
    Wyszukuje w kodzie zaszyte kolory, odstępy i typografię oraz błędne odwołania do tokenów designu.
  • 90design-token-audit
    Sprawdza użycie tokenów w produkcie: pokrycie, rozjazdy i zakodowane na sztywno wartości, gdy tokeny już istnieją.
  • 90tone-recon
    Audytuje użycie tokenów projektowych w bazie kodu: znajduje literalne wartości, brakujące tokeny i luki w potoku.
  • 100pf-code-token-check
    Wykrywa w CSS, SCSS, CSS-in-JS i stylach inline zakodowane na stałe kolory, odstępy, typografię, promienie i cienie, które mają odpowiedniki w tokenach PatternFly.
  • 100pf-css-token-check
    Wykrywa w CSS, SCSS, CSS-in-JS i stylach inline zakodowane na stałe kolory, odstępy, typografię, promienie i cienie, które mają odpowiedniki w tokenach PatternFly.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.