GitHub-README Hero.skill

一份薄弱的 README 试图解释自己；一份有力的 README 则自带气场，不言自威。

本 skill 面向那些已具备明确语调、一句有力的表达或一个真实想法的页面——但当前呈现仍停留在原始 Markdown 状态，尚未成为一张精心设计的首页。

当用户希望将 README、skill 页面或类似落地页风格的 Markdown 文档，升级为更具设计感的首页时，请使用本 skill：

• GitHub README 美化
• ClawHub skill 页面润色
• hero-section 重构
• 引用语 + 徽章 + 横向导航 布局
• 在提升视觉呈现的同时，保留原有开篇中最具力量的核心内容
• 优化以中文为优先语言的 README 首页
• 让 skill 页面更贴近产品展示页（product showcase）的质感
• 仅重设计首屏（first screen），同时完整保留原文中最有力的一句话

请勿将本 skill 用于通用文案撰写、长篇文档编辑，或整站实现——除非用户明确要求仅对文档本身进行视觉重排版（restyling）。

核心承诺

切勿删除页面的灵魂。

你的任务不是用装饰性修辞替代作者最精彩的一句；而是要：

1. 识别原文中最有力的一句、一段引文或一个段落
2. 将其升华为更具冲击力的首屏内容
3. 完整保留其下方原有的实质内容
4. 让整页呈现出明确意图、干净利落且令人难忘的观感

本 skill 的目标是 sharpen the entrance（强化入口），而非 erase the voice（抹除声音）。

默认工作流

1. 优先通读文档顶部

编辑前，先检查前 30–80 行内容。

重点关注：

• 最具引用价值的一句强表达
• 真实的标题（可能隐含于正文而非显式 `#` 标题）
• 该页面是否为双语页面
• 是否已有值得链接的实用章节
• 当前顶部是否枯燥、杂乱或视觉表现力薄弱

2. 决定 hero 区域结构

在适用情况下，优先采用以下顶层结构：

# Title

> Strong quote or distilled line

![badge](...)
![badge](...)


  horizontal navigation



  short subtitle or two-line promise




---

仅当该结构确实能提升页面质量时才使用；切勿强行套用于需要简洁技术性开篇的文档。

3. 保留原始引言

在 hero 区块之后：

• 若原始开篇具有文学张力或品牌价值，则予以保留
• 仅删减因新增 hero 区块而引入的重复内容
• 切勿将富有表现力的原文压缩为平淡的产品化语言

若作者已写出一段有力的引言，请让它继续鲜活存在。

4. 克制地添加徽章（badges）

徽章应传递结构性信息，而非沦为视觉“彩纸”（confetti）。

合理用途包括：

• 双语标识
• 模式（mode）或类别（category）
• 平台（platform）
• 输出风格（output style）
• 标准 / 工作流类型（standard / workflow type）

不合理用途包括：

• 五个徽章全部传达相同信息
• 随意堆砌的彩虹色杂乱元素
• 虚构的技术权威性标识

默认徽章数量：3–5 个。

样式首选 flat-square，除非仓库已统一采用其他样式。

5. 设置横向且实用的导航栏

若页面足够长、确有导航必要：

• 在顶部附近添加一行居中的横向链接
• 仅链接至真正高价值的章节
• 必要时创建稳定、可复用的锚点 ID（anchor ids）

优质示例包括：

• 中文 / English
• Install
• Usage
• Examples
• Prompt
• Output

若文档过短，无需导航，请勿强行添加。

6. 仅使用渲染安全的 HTML

优先使用 Markdown，并辅以极简、在 GitHub 类平台能稳定渲染的 HTML：

请避免使用：

• 内联 CSS
• JavaScript 脚本
• 仅为装饰目的构建的复杂表格
• 在 GitHub 或 ClawHub 上易失效的脆弱 HTML 技巧

7. 尊重双语逻辑

若页面为双语：

• 严格遵循用户指定的语言顺序
• 保持各级标题格式一致
• 除非原文已明确采用混排风格，否则不要在单行内随机混用中英文

用户要求中文优先，则保持中文优先；要求英文优先，则保持英文优先。

针对面向中文用户页面：

• 默认采用中文优先的文案与导航标签，除非用户明确要求英文优先
• 若中文表达具有品牌价值（如凝练的成语、诗意句式等），请予以保留
• 切勿将生动的中文引言扁平化为僵硬的产品说明文
• 首要确保中文用户可顺畅阅读，再追求对更广泛受众的视觉感染力

编辑原则

• 优先通过视觉层级（visual hierarchy）而非增加文字来传递信息
• 宁取一句有力的引语，不取三句平庸的口号
• 宁取一个干净的 hero 区块，不取多个花哨的装饰性技巧
• 始终保留原文中最强有力的表达
• 确保首屏在纯 Markdown 源码视图与渲染后视图中均清晰可读
• 让页面看起来是「经过设计的」，而非「过度设计的」

输出规范

执行编辑时：

• 确保页面作为 Markdown 仍完全可用
• 所有链接与锚点必须有效
• 章节顺序须符合逻辑流
• 未经用户明确要求修改文案，不得改动原有语义
• 简要说明你做了哪些修改及原因

若用户提供了具体风格参考：

• 借鉴其布局逻辑与设计范式
• 严禁照搬原文措辞（plagiarize exact wording）
• 将风格适配至用户自身的实际内容与表达语调

典型触发场景（应启用本 skill 的请求）

• “让我的 README 看起来像一个落地页”
• “为什么他们的 README 看起来比我专业那么多？”
• “添加居中标题、徽章和横向导航”
• “保留我的引言，但让顶部更美观”
• “把这个 skill 页面变成海报风格的封面”
• “让这个 GitHub / ClawHub 页面显得更高端（premium）”
• “把我的 GitHub README 改成这种首页布局”
• “保留原始引言，但让顶部更有 premium 感”
• “以这张截图作为参考，把我的 skill 页面改造成展示型页面（showcase-style page）”