Skip to main content
skill CX Codex

token-normalizer — Claude Code skill: token proposals and setup

token-normalizer is a Claude Code skill that turns repeated implementation values into reviewable semantic token proposals. It keeps existing names and flags exceptions instead of forcing merges.

MIT ★ 529 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ShuaiMXu/happyhands --skill token-normalizer -a claude-code
Open on GitHub

What token-normalizer does

token-normalizer collects repeated implementation values into a semantic token proposal with supporting evidence. It needs raw values, existing token aliases, and the locations where those values are used.

The skill preserves current semantic names, lists each proposed merge, and flags exceptions rather than forcing them together. Frequency by itself does not establish that two values mean the same thing.

Its output includes structured evidence, findings, proposed updates, and limitations. If required inputs or professional review are missing, it uses needs-evidence; it does not turn observations from one project into universal rules.

What it helps with

  • group repeated visual values into token proposals
  • compare raw values with existing token aliases
  • list proposed merges for review
  • flag exceptions without forcing a merge

Example prompts for the agent

  • Map these repeated visual values to semantic tokens and show the evidence for each proposal.
  • Compare these values with existing token aliases and flag possible merges.
  • Draft a token proposal with usage locations and list the exceptions.

How to install token-normalizer

1Skills CLI (Vercel)

npx skills add ShuaiMXu/happyhands --skill token-normalizer -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/token-normalizer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about token-normalizer

How do I install token-normalizer in Claude Code?

Run npx skills add ShuaiMXu/happyhands --skill token-normalizer -a claude-code. The skill file is at ~/.claude/skills/token-normalizer/SKILL.md.

What does token-normalizer do?

It turns repeated implementation values into semantic token proposals with evidence for review. It lists proposed merges and flags exceptions.

What inputs does token-normalizer need?

It needs raw visual values, existing token aliases, and usage locations. When required inputs or professional review are missing, it uses needs-evidence.

Source text

SKILL.md · MIT
---
name: token-normalizer
description: "Map raw visual values and aliases into candidate semantic design tokens without silently changing the product."
---

# Token Normalizer

Turn repeated implementation values into a reviewable semantic token proposal.

## Required evidence

- raw values
- existing token aliases
- usage locations

## Decisions

- Preserve existing semantic names
- Show every proposed merge
- Flag exceptions instead of forcing them

## Boundary

Frequency alone does not determine semantic equivalence.

Return structured evidence, findings, proposed updates and limitations. Use `needs-evidence` when required inputs or professional review are missing. Never invent an Experience Score or promote a project observation into a universal rule.

© ShuaiMXu · MIT · ShuaiMXu/happyhands

Similar skills

All skills for Design →

From the same set34

The whole set →
change-impact-mapper change-impact-mapper is a Claude Code skill that links code edits to affected routes, components, and user tasks. It helps agents choose what to review after a change. CX Codex +1 ★ 529repo stars error-recovery-reviewer error-recovery-reviewer is a Claude Code skill that inspects failure states, recovery flows, and data safety. It runs when evaluating critical user tasks against disruptions. CX Codex +1 ★ 529repo stars incremental-review-router incremental-review-router is a Claude Code skill that chooses review skills for the parts of a project affected by a change. It factors in relevant tasks, artifacts, and regression-related history. CX Codex +1 ★ 529repo stars expertise-candidate-author expertise-candidate-author is a Claude Code skill that drafts general guidelines from recurring human decisions. It keeps context links and edge cases visible. CX Codex +1 ★ 529repo stars skill-regression-evaluator skill-regression-evaluator is a Claude Code and Codex skill that audits skill versions against regression suites. Catches regressions before knowledge updates break established behavior. CX Codex +1 ★ 529repo stars responsive-reviewer responsive-reviewer is a Claude Code skill that checks matching desktop and mobile interface states. It focuses on whether the main task stays clear and usable across screen sizes. CX Codex +1 ★ 529repo stars regression-case-author regression-case-author is a Claude Code skill that turns reviewed product changes into portable regression test cases. It preserves concrete examples for future agent evaluations. CX Codex +1 ★ 529repo stars accessibility-reviewer accessibility-reviewer is a Claude Code skill that reviews interface accessibility using browser and source evidence. It checks semantics, keyboard behavior, contrast, and accessible states. CX Codex +1 ★ 529repo stars

Project sponsors

Companies that keep this analytics open