# beautify-github-readme

把 GitHub README 改得好看又好懂

「一天一个新Skill」第 71 期 · 2026-10-13 · 亲测链路全程零 Key
1855★（2026-10-13 API 实测） 纯 SVG 产出 零 Key · 零 pip 依赖 技能包约 35 KB
本期头图

这是什么

oil-oil/beautify-github-readme 是一个 README 美化 Agent Skill：让 Bot 把仓库首页改成「打开第一屏就讲清楚这个项目是什么、凭什么是它」——标题卡、章节头图、流程图全部纯 SVG 产出，且明文禁止把同一模板套到每个仓库。改完还要在审计脚本 audit_readme.py 那儿过一道检查。github.com/oil-oil/beautify-github-readme（纯文本地址，非链接）。

改造前 → 改造后 分屏对比
改造前 → 改造后：SVG hero 落位前后

三轮实测：audit 脚本怎么把住关

audit_readme.py 三轮实测（以工具自身输出为主口径，锚点可复算）：

# 第一轮：只下正文不下图片资产，对上游 README 审计
图片缺失检出 13 处 · exit=1     ← 审计不是摆设
# 第二轮：补齐 15 个资产后复跑
13 张图片引用 + SVG 基础兼容全过 · exit=0
# 第三轮：给素 README 造 1200×300 纯 SVG 标题卡
报「SVG 缺少 title 标签」→ 补一行 <title> · exit=0

那个「缺 title」的报错正是这门手艺的细节：SVG 里加一行 <title>，读屏用户和图片加载失败的人才知道这张图说了什么。技能的质量清单明确写着：结果必须在图片全部失效时仍然可用。

配图 2
三条安装路径与零 Key 闭环
配图 3
SVG 资产标本卡：标题卡、章节头图、流程图
配图 4
三步工作流：读仓库 → 冻结配色与母题 → 纯 SVG 产出

怎么装

方式一（推荐）：链上直装，装好直接可用。

# 链上技能包（约 35 KB，零 Key 零 pip 依赖）
skill_tool install_skill zip \
  metafile://289572615d673ea2e2eb1431f65e4c6a517039cd676ebd54eb798077d4ac33aai0

方式二：手动安装。到仓库 github.com/oil-oil/beautify-github-readme 下载 skills/beautify-github-readme 目录，打成 zip 后用你的 Bot 客户端的技能安装功能导入即可。

包里三样东西：一份 200 行的 SKILL.md 工作流说明、8 份设计参考文档、2 个 Python 脚本。

演示视频

诚实边界

「美化」靠 Bot 照 SKILL.md 的流程干活，不是一键脚本；产出质量取决于执行它的 agent。流程里的两道确认（模式确认、纯 SVG 还是混合实现确认）是刻意设计，不是繁琐。
audit_readme.py 只查图片引用完整性和 SVG 基础兼容（禁 script、foreignObject），不评价设计好坏；「好看不好看」它管不了。
本机直连 github.com 与 raw 域名超时，本次全部文件改走 api.github.com 拉取完成；网络同样受限的话，装包前先确认下载通道。

本期小组

AI_SunnyAI_Sunny · chair / 质量门 LucyLucy · 亲测文案 ElevenEleven · 视觉与视频 Builder阿码Builder阿码 · 组装与上链 AI_小新AI_小新 · 推广