| name | skill-landing-generator |
| description | 为 Agent Skill 生成统一的落地页（landing）、手册页（manual）和 SKILL.md 源文档页（source）HTML。基于统一设计规范，确保所有 Skill 介绍页面视觉语言一致。触发场景：(1) 用户要求为某个 skill 生成 landing/介绍页面；(2) 用户要求为某个 skill 生成 manual/手册/文档页面；(3) 用户要求展示或渲染 SKILL.md 原文；(4) 用户要求生成 skill 介绍页、文档页或源码页。输入：skill 名称 + skill 文档内容。输出：三个互相链接的 HTML 文件。 |
| metadata | {"author":"wen.yuan"} |
Skill Landing Generator
为任意 Agent Skill 生成一组统一风格的 HTML 页面：落地页 + 手册页 + SKILL.md 源文档页。
设计规范
所有页面必须严格遵循 references/design-token.md 中的设计规范。生成前必须先读取该文件。
设计规范涵盖：色彩系统、字体系统、间距系统、组件规范、布局规范、交互规范、代码高亮规范、命名约定。
生成流程
1. 收集信息
读取目标 skill 的文档（SKILL.md / README.md），提取：
- 名称：skill 名称（用于文件命名和页面标题）
- 一句话描述：用于 hero 区域和 meta description
- 前置条件：需要安装的工具、权限、环境
- 核心功能：完整特性点（图标 + 标题 + 描述），不限制数量，尽可能详细覆盖全部功能
- 工作流程：完整工作流程（tag + 标题 + 描述），不限制步骤数量，尽可能详细覆盖全部子流程
- 命令/用法：主要命令及参数说明
- 配置/状态标记：配置项、状态标记、输出格式等
- 注意事项/限制：已知限制和使用注意
2. 生成落地页
参考 assets/landing-template.html 的结构。顶部导航必须同时包含手册页和 SKILL.md 源文档页入口。
Hero 徽章规则：如果 skill 有远程来源链接（GitHub 仓库、SkillHub 页面等），Hero 顶部显示来源链接徽章（.repo-badge，等宽字体展示地址，左侧点击跳转，右侧按钮一键复制地址，复制成功显示 ✓ 反馈）。图标按域名选择：github.com 用 GitHub 图标，其他远程链接用通用链接图标。如果没有来源链接，则完全不显示徽章。
核心区块：
Nav (sticky)
├── Hero（双栏：文案 + 终端模拟器）
├── 前置条件（双栏：说明 + 代码块）
├── 核心功能（完整特性卡片网格，3 列 auto-fit）
├── 工作流程（完整步骤卡片，auto-fit 自适应网格）
├── 用法示例（全部用法卡片，auto-fit 自适应网格）
├── 状态/配置说明（可选，按需）
├── CTA（居中号召）
└── Footer
文件命名：{skill-name}-landing.html
3. 生成手册页
参考 assets/manual-template.html 的结构。顶部栏必须同时包含落地页和 SKILL.md 源文档页入口。
Page Meta 规则：页头 meta 行除版本/更新日期外——SKILL.md frontmatter 有 author 字段时显示作者信息，无则省略；有远程来源链接（GitHub / SkillHub 等）时显示来源链接（新标签页打开，链接文案统一为 来自 GitHub / 来自 SkillHub 格式），无则省略。
核心区块：
Topbar (sticky, blur backdrop)
├── Sidebar（260px，分组导航，ScrollSpy 高亮当前章节）
└── Main（1fr，max-width 1100px，居中）
├── Page Header（eyebrow + h1 + lede + meta）
├── 概述
├── 前置条件
├── 快速开始
├── 各命令详解（h2，含参数表、流程表）
├── 进阶主题（文件处理、冲突、映射文件等）
├── 限制与注意
└── Prev/Next 导航 + Footer
文件命名：{skill-name}-manual.html
4. 生成 SKILL.md 源文档页
参考 assets/source-template.html 的结构。
- 读取目标 Skill 的
SKILL.md 完整原文，包括 YAML frontmatter。
- 在生成阶段把 Markdown 转换为语义化 HTML，写入 Source 页正文；不要在浏览器运行时通过
fetch() 请求本地 Markdown。
- 同时把经过 HTML 转义的完整原文写入“原文”视图，确保读者可以在“渲染结果 / 原文”之间切换。
- 保留原文顺序、标题层级、列表、表格、引用、代码块、链接和行内代码；不得省略、改写或补写源文档内容。
- Source 页底部必须包含统一品牌页脚。
文件命名：{skill-name}-source.html，页面入口文案统一使用 SKILL.md，索引卡片入口文案统一使用 Source。
5. 互相链接
- 落地页 nav 中链接到手册页和 Source 页
- 手册页 topbar 中链接回落地页和 Source 页
- Source 页 topbar 中链接回落地页和手册页
- 三个页面放在同一目录，全部使用相对路径
6. 更新索引卡片
如果输出目录中存在 index.html，并且索引卡片由 Skill 数据生成：
- 为当前 Skill 的数据项设置
source: true
- 在卡片链接区按
source 字段条件渲染 <a href="{skill-name}-source.html">Source</a>
- 不要为尚未生成 Source 页的旧 Skill 显示入口，避免产生 404 链接
一致性检查清单
生成后逐项验证：
