Repository navigation
Releases
v0.3.4 — the design half gets eyes
A generated brand is now checked against what it actually renders, and the health check reports refuted structural directions instead of passing over them. Nothing breaks: the audit script's exit codes are unchanged.
Install
/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz
No Claude Code marketplace? Download ui-contract-0.3.4.zip below — its README covers both install paths, including install.sh for other agents' skill directories.
What changed since 0.3.3
ui-contract-design — originating a brand (ADR-0017)
- Tear down real references first. Before the three directions are offered, two or three real products in the category are taken apart and recorded in
design.md§1 — what was kept, what was deliberately broken. The look-alike checks now run against those instead of a thought experiment. - Vague words get translated. An aesthetic adjective ("cleaner", "more premium") has to become the token group it moves and one observable decision.
- The tuning session has a close. A fixed visual baseline (the prototype wall, a 480px frame, 200% crops of the two densest controls), a three-second check on it, then one context-free review that reports whether the surface still reads as the chosen direction. The review can be skipped, but a skip is written into §1 rather than left silent.
- Motion states its basis. §8 values say where they come from — the product's state rhythm, the platform's convention, the signature treatment — or are marked as the weakest section.
ui-contract-audit — the health check
- Check 10 now lifts refuted (⛔) rows verbatim, separately from pending (⏳) ones. Before, it could not see them at all.
- The report ends with a machine-readable
AUDIT-JSONline: pass / skip / fail for each check, and the warning count. The prose report and the exit codes are unchanged.
Other
- The
ui-contractskill no longer carries a staleversion: "0.2.0";plugin.jsonis the one version. - Development only (not in the zip): CI now runs the same
./testing/run.shmaintainers run locally, and the repository gained a security policy and issue / pull request templates.
中文说明
生成品牌(ui-contract-design):
- 提出三个方向之前,会先拆解两三个同类的真实产品作为参照。
- 「更干净」「更高级」这类形容词,必须翻译成具体要动的颜色、间距等设计变量(token),以及一个看得见的决定。
- 调校收尾时会截一组固定的对照图,做一次「看三秒」检验,再请一个不知道前情的评审者判断:结果还像不像当初选的方向。评审可以跳过,但跳过要写进 design.md。
- 动效数值必须写明依据。
体检(ui-contract-audit):第 10 项检查现在会把「已被否决的方向(⛔)」原样列出来,以前完全看不到;报告末尾新增一行机器可读的汇总。退出码不变,不影响现有的 CI。
ui-contract-0.3.4.zip · SHA-256 ba8d08fcd4bb877b0d25b27fd20e6f6d3ba347905f48da771b9a756f017a828b
v0.3.3 — frontmatter fix
Fixes three skills that strict YAML parsers refused to load. If you installed 0.3.2 (or 0.3.1), update.
Install
/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz
No Claude Code marketplace? Download ui-contract-0.3.3.zip below — its README covers both install paths, including install.sh for other agents' skill directories.
What changed since 0.3.2
- Fixed: the
descriptionofui-contract,ui-contract-designandui-contract-auditcontained an unquoted:, so their frontmatter was not valid YAML. Lenient readers still got the text; strict parsers rejected the file, and GitHub showedmapping values are not allowed in this context. The values are now quoted and read exactly as before. This was present since 0.3.1. - The wording of every skill is otherwise unchanged.
- Development only (not in the zip): a new structural check fails the build when any
SKILL.mdfrontmatter cannot be parsed, so this cannot ship again unnoticed.
中文说明
修复了 3 个技能(ui-contract、ui-contract-design、ui-contract-audit)开头元信息的格式错误:描述里有没加引号的冒号,按严格规则解析的工具会直接拒绝加载这 3 个技能。0.3.1 和 0.3.2 都有这个问题,装过的话请更新。技能内容本身没有变化。仓库里另外新增了一条自动检查,同类错误以后无法再被发布出去。
ui-contract-0.3.3.zip · SHA-256 3ce9f3c6ec62a34c14a7ba172f729a8c081f9fc1cf260300b72b0c98e562f833
v0.3.2 — first public release
First public release of ui-contract: 15 skill packages for Claude Code that establish a project's UI contract — a structural spec with a placement decision tree and a region-name allowlist, a visual spec whose values live in the token file, an asset layer, a low-fidelity wireframe, and enforcement that stops coding agents from putting new features in the wrong place.
Install
/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz
No Claude Code marketplace? Download ui-contract-0.3.2.zip below — its README covers both install paths, including install.sh for other agents' skill directories.
What changed since 0.3.1
- Licensed under MIT, copyright @yannikzz and @loot20mal. The manifest gains a
licensefield, and the zip now shipsLICENSE. - The skills themselves are unchanged. If you already have 0.3.1, updating only brings the license.
中文说明
第一个公开版本。和 0.3.1 相比,技能内容没有任何变化,唯一的变化是加上了 MIT 协议:manifest 多了 license 字段,zip 里多了 LICENSE 文件。已经装了 0.3.1 的话,更新后只会多出这份协议。
ui-contract-0.3.2.zip · SHA-256 adef3016cda772b2ac7968751f73b27af04a4202f6efb36a16fd76751c30907c