v1.6.0 — 10-hue examples + low-friction README

Added · 新增

• Examples 从 4 个色系扩到 10 个，覆盖完整色轮：red / orange / amber / green / teal / blue / indigo / violet / pink / warm，每个 --format all 一次出全 5 种格式（css / html / json / tailwind / scss）。
• examples/index.html 画廊重写为 10 色系网格：每张卡用真实生成的 token 值渲染明暗双主题 UI 样例（含 on-brand 按钮 + error/warning/success 语义色点），线上预览同步刷新。
• README 借鉴成熟跨 agent skill 的「低门槛」写法（参考 nextlevelbuilder/ui-ux-pro-max-skill）：
  • 痛点开场钩子（"Why does your UI look cheap?" / 「为什么你的 UI 看起来很廉价？」）
  • 目录导航 (TOC)
  • 10 色系示例表（品牌色 / 浅深背景 / on-brand 对比度 / 预览链接）
  • FAQ / 自助排查小节（中性色品牌、格式、框架兼容、手调、WCAG 保证）
  • 中英文同步。

Docs · 文档

• examples/README.md 更新为 10 色系表。

Changed

• SKILL.md → 1.6.0；CHANGELOG / README 同步。

v1.5.0 — skill.json + 15 agents + pre-delivery checklist

Added · 新增

• 标准 skill.json 清单（仓库根目录）—— 可移植、对各大市场友好的技能描述（name / displayName / version / keywords / platforms / install），对齐成熟跨 agent skill 仓库的惯例。
• 再扩 6 个 agent，覆盖 8 → 15。 新增原生规则文件：Kiro（.kiro/steering/）、RooCode（.roo/rules/）、Kilo Code（.roo/rules/）、Trae（.trae/rules/）、CodeBuddy（.codebuddy/rules/）、Augment（.augment/rules/），各自带正确的 frontmatter。兼容性表见 README，接入文档见 agents/。
• 交付前验收清单 + 反模式（references/principles.md）：8 项可达性验收清单与「常见错误」段落，发布前可逐项核对。已接入 SKILL.md 与 INSTRUCTIONS.md。
• 社区健康文件：CODE_OF_CONDUCT.md（Contributor Covenant）与 SECURITY.md。
• README 徽章升级（版本 / star / 15-agent 平台数 / WCAG AA，中英双语）+ 双语「交付前验收清单」段落 + 路线图更新。

Changed · 变更

• CI 现强制版本一致性：SKILL.md 版本 == CHANGELOG 顶部版本；发布 tag 触发时再校验 tag == 版本。漏改版本会导致 CI 失败，而非悄悄发布。
• 新增 .gitignore（pycache / OS / 编辑器）。

v1.4.1 — on-brand WCAG fix + format tests + agent docs

Fixed · 修复

• --color-on-brand 现在对每个品牌色都保证 WCAG AA (≥4.5:1)。 之前只在近白/近黑里二选一、没有补偿到下限，导致暖中调如橙色 #C4502A 只有 4.40:1。现在走和正文文字相同的 ensure_contrast 微调，蓝/绿/红/橙/紫均 ≥4.5:1。（由新增的多色相对比度检查捕获。）

Added · 新增

• CI 现在测试每种输出格式，不再只测 CSS。 scripts/smoke_test.py 新增 check_formats()：生成 --format json/tailwind/scss/all，断言退出码 0，解析 DTCG JSON（并重锁 bg 金值），校验 tailwind.config.js / _tokens.scss 结构；并断言 5 个色相的 on-brand 对比度 ≥4.5，拓宽了原先只锁蓝色的 golden。

Docs · 文档

• 全部 7 个非 Claude agent 规则文件（Cursor / Codex / Cline / WindSurf / Copilot / Gemini CLI / Aider）现已写明 v1.4.0 参数：--format、--tint-strength、以及自动产生的 --color-on-brand。

Changed

• SKILL.md → 1.4.1；CHANGELOG / README 同步。

v1.4.0

What's Changed

This release turns the "premium UI color" promise from a design opinion into a verifiable, automatic guarantee.

New in v1.4.0

• WCAG 2.1 auto-contrast & compensation — every text-on-surface pair is checked against the WCAG relative-luminance formula. If a pair drops below AA (4.5:1 for normal text, 3:1 for muted), the text is nudged along its HSL lightness axis until it passes. Readability always wins, and the brand hue-lean is preserved wherever lightness does not hit an extreme.
• --color-on-brand — a readable text/icon color to place ON the brand color. The generator picks a tinted near-white or near-black by contrast ratio, never pure #FFF/#000. A primary button in preview.html now demonstrates it.
• Adjustable tint strength — --tint-strength subtle|normal|strong scales every blend factor uniformly (0.6 / 1.0 / 1.6) so users can dial brand presence up or down without editing code.
• Industry export formats — --format now supports:
  • json — W3C DTCG design tokens (color/* + shadow/*)
  • tailwind — ready-to-use tailwind.config.js
  • scss — _tokens.scss light + dark variables
  • all — css + html + json + tailwind + scss
    Existing css / html / both options remain unchanged.
• Numeric golden-value regression test — scripts/smoke_test.py locks 9 key tokens for #2563EB (normal) to exact hex values and asserts the three critical WCAG AA pairs (light text/surface, dark text/bg, on-brand) stay ≥ 4.5:1. This catches silent numeric drift like the old HSL→RGB channel-mapping bug.
• Updated docs — SKILL.md, INSTRUCTIONS.md, README.md, references/principles.md, CHANGELOG.md and the CI description all document the new features.
• Regenerated preview image — assets/preview.png now shows the new on-brand primary button in both light and dark themes.

Verification

• python scripts/validate_skill.py → PASS
• python scripts/smoke_test.py → PASS
• GitHub Actions Validate Skill will run the same checks on this release.

v1.3.1

What's Changed / 变更内容

Fixed / 修复

• 修复 preview.html 暗色模式顶部标题不可见的问题：.brand-meta b 原本只继承 body 颜色，在暗色卡面上解析为深色后几乎不可见。现显式指定 color: var(--color-text);，标题在明/暗主题下均可正确解析并保持可读。
• 使用修复后的 preview.html 重新生成 assets/preview.png，README 预览图暗色半边现在能清楚看到 "Sample" 标题。
• 同步更新 README 英文与中文预览说明，注明顶部标题在两种主题下均保持清晰可读，避免单语言漏改。

Full Changelog / 完整记录

See CHANGELOG.md.

v1.3.0

What's New / 新增内容

• README「一键安装」区：按 8 个 agent（Claude Code / Cursor / OpenAI Codex / Cline / Aider / WindSurf / GitHub Copilot / Gemini CLI）列出复制即用的安装命令，clone 仓库后直接把规则文件指向对应 agent 即可。
• 真实浏览器渲染预览图 assets/preview.png：明暗双主题并排实拍（品牌色 #2563EB），比 SVG 更直观。

这个 skill 是做什么的

输入一个品牌色，自动生成一整套「染色中性色」设计 Token 系统（tokens.css + preview.html，明暗双主题）。核心原则：任何地方都不出现纯 #FFFFFF / #000000 / #808080——每个背景、表面、边框、文字层级、阴影、语义色都带上一小撮品牌色的温度，让 UI 不再显廉价。

为什么用

• 品牌无关：任意 hex，不是写死的两套配色。
• 跨 agent：引擎是纯 Python 脚本，指令是一份可直接粘贴的 Markdown，已为 8 个主流 AI 编程 agent 备好现成规则文件。
• 零依赖：仅 Python 标准库，无需 pip install。
• 免费：MIT 协议。

适合谁

设计师 / 前端 / 团队 —— 想快速拿到高级、统一品牌感的配色，又不想手调几十个灰阶。

git clone https://github.com/truman-t3/tinted-ui-tokens-skills ./tinted-ui-tokens-skills
python ./tinted-ui-tokens-skills/scripts/generate_tokens.py --brand "#2563EB" --name "Acme" --out "./out"

完整历史见 CHANGELOG.md。

v1.2.0

What's Changed / 变更内容

三项增强，让仓库更接近成熟 skill 的发布状态：

极端色 CI 健壮性测试

• 新增 scripts/smoke_test.py，CI 与本地共用同一份测试（"本地通过" == "CI 通过"）。
• 覆盖冷/暖/中性三色冒烟、每个 --color-* 合法 hex 校验、语义色健全性、非法输入拒绝，以及极端/退化品牌色（纯黑 #000000、纯白 #FFFFFF、纯灰 #808080、短 hex、小写）不崩溃。
• validate.yml 改为调用 smoke_test.py，新增极端色覆盖。

各 agent 现成规则文件

• 为其余 agent 提供开箱即用的原生规则文件（复制即用，无需手动拼装）：
  agents/codex/AGENTS.md、agents/aider/CONVENTIONS.md、agents/windsurf/.windsurfrules、
  agents/cline/.clinerules、agents/copilot/copilot-instructions.md、agents/gemini-cli/GEMINI.md
  （Cursor 早已提供 tinted-ui-tokens-skills.mdc）。
• 各 agent README 与 agents/ 索引表同步指向现成文件。

README 预览图

• 新增 assets/preview.svg（基于真实 #2563EB Token 值绘制的明/暗双主题预览），中英文两个区块均已嵌入。

本地 validate_skill.py 与 smoke_test.py 均通过。完整记录见 CHANGELOG.md。

v1.1.0

What's Changed / 变更内容

• 新增 MIT LICENSE 文件（README 早已声明 MIT，但实体文件此前缺失）
• SKILL.md 的 name: 从 tinted-ui-tokens 同步为 tinted-ui-tokens-skills，与仓库 slug 对齐
• Cursor 规则文件重命名 tinted-ui-tokens.mdc → tinted-ui-tokens-skills.mdc，对应 README 引用同步更新
• 新增 CHANGELOG.md 与 CONTRIBUTING.md

本地校验 python scripts/validate_skill.py 通过，CI 应跑绿。完整记录见 CHANGELOG.md。

v1.0.0

v1.0.0

First stable release of tinted-ui-tokens-skills（品牌色 UI 设计 Token skills）.

What's included

• Cross-agent skill — works in Claude Code, Cursor, OpenAI Codex, Cline, Aider, WindSurf, GitHub Copilot, Gemini CLI, and WorkBuddy.
• Engine — scripts/generate_tokens.py: one brand hex → a full brand-tinted CSS token system (light + dark).
• Agent-neutral instructions — INSTRUCTIONS.md, wired into each agent via the docs in agents/.
• Bilingual README — English + 中文, with a cross-agent compatibility table.

Philosophy

No pure neutral colors anywhere (#FFFFFF, #000000, #808080): every background, surface, border, text layer, shadow, semantic color, gradient, and icon picks up a few percent of the brand's temperature.