把 README 首屏从命令堆变成一眼看得懂的项目页
beautify-readme 让你已经登录的 coding agent 先读你的仓库——README、代码、示例、真实产物—— 再从项目本身推导 palette / typography / motif，产出一张属于这个项目自己的 hero、几张章节转场、一版重排后的 README 和 diff。whole-README 一次改完首页，asset-only 只出资源包不动 README 一个字节。
同一个 Skill，不同项目就该有不同的视觉方向
左：Skill 在 beautify-github-readme 自己仓库上跑出的 hero——REPOSITORY · FIRST IMPRESSION 作为定位， 三张斜倚 motion card 作为 motif，深墨底 + 珊瑚红 accent。右：同一 Skill 在六种项目类型（dev tool / AI product / design resource / data research / creator / OSS library）上产出的六张 hero，palette 和 motif 各自不同—— 不是给每个仓库套一份「AI 紫 + 黄铜暖米」默认样。
#121827 + 珊瑚红 #FF7458 + 薄荷 #63D3BE
+ 系统字。motif 是三张不同产品语言的 motion card，从项目自身内容（dev tool / design system / AI product）来。
你会拿到的第一张图就是这种「换掉项目名就不成立」的原生 hero。
章节转场共享同一 palette · motif · typography
章节转场不是装饰条，它们是 README 里 why / how / use 三个信息位的视觉承接。每张 SVG 都写了具体 caption 说明它承接的是什么，palette / motif / 字号权重全在一套系统里。你会在自己的仓库拿到相同结构的一组。
四个真实项目 → 四种视觉方向
Skill 在四个大家都认得的公开仓库上做完 read-first pass 后各自锁定的 palette / motif。QA 判「反默认」用的就是这类 对照——同一个 Skill，PyTorch 不应该和 Rust 长得像。
#3F1F73 + 火橘 #EE4C2C，motif 是研究模型的坐标轴节点。
#D66200 + 深墨底，motif 是齿轮 + 编译 flow，带 CLI 铁气。
#0B1E3F + 大象蓝，motif 是三段式 SQL 语句 + 数据行。
#326CE5 + 白网格，motif 是七边形舵轮 + pod 阵列。信息顺序被重排：先讲用途 · 再放示例 · 再讲原理 · 最后是安装
同一仓库的 README 首屏对比——左边是常见的「标题一句 + 一段命令堆 + 目录树」，右边是 Skill 跑完 whole-README 后的重排：hero 到位、proof 挪到前面、install 挪到 first use 附近、CTA 只留三个 label。
project-name
a small tool for developers.
# Installation npm install project-name # Usage npx project-name --help # Structure src/ cli.ts runner.ts tests/ cli.test.ts package.json LICENSE # Contributing PRs welcome. # License MIT
- 没有一句话讲清楚它做什么
- 安装排在最前面，示例没有出现
- 目录树抢在 first-use 之前
- 看完首屏依然不知道要不要装
- hero 到位——项目名 + 一句话价值 + 项目原生 motif；换个仓库就不成立
- proof 挪到前面——先给一段真实运行截图或 output，再讲原理
- first use 一步——npx / one-line install 出现在示例旁，不再单独一屏
- 清掉重复承诺——不再有三个「简单易用」，只留一句真话
assets/readme/*.svg 是新的。