Communitygithub.com

FlorianBruniaux/claude-code-ultimate-guide

从任意代码仓库生成完整、可部署的落地页。适用于为开源项目创建首页、搭建项目网站、将 README 转化为营销页面,或在多个仓库间统一落地页风格。

claude-code-ultimate-guide 是什么?

该技能能够自动分析任意 GitHub 仓库的文档(如 README.md、CHANGELOG.md 等)和结构,提取标题、标语、功能列表、安装步骤、截图等核心内容,并映射到预定义的页面部分(Hero、功能、安装、FAQ、页脚等),最终生成一个完整的静态落地页(HTML + CSS + JS)。生成的落地页可以直接部署到 GitHub Pages,并包含 GitHub Actions 工作流。用户可以通过多种选项(如风险横幅、定价表、主题、搜索等)自定义落地页的外观和内容。该技能支持 Claude Code、Cursor 和 Codex 等 AI 代理平台,特别适合需要为多个项目快速生成统一风格网站的开发者和团队。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/examples/skills/landing-page-generator

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

落地页生成器

通过分析仓库的文档和结构,从任意代码仓库生成完整、可部署的落地页。

何时使用此技能

  • 为 GitHub 仓库创建落地页
  • 从现有文档生成静态站点
  • 在多个项目中统一落地页风格
  • 将 README 内容转换为营销/展示页面

此技能的功能

  1. 分析仓库:读取 README.md、CHANGELOG.md、package.json/VERSION、docs/、assets/
  2. 提取内容:识别标题、标语、功能、安装方式、截图
  3. 映射到页面部分:Hero、功能、安装、FAQ、页脚(+ 可选:风险横幅、定价表)
  4. 生成落地页:创建完整的静态站点(HTML + CSS + JS)
  5. 可部署的输出:包含用于 GitHub Pages 的 GitHub Actions 工作流

如何使用

基本用法

/landing-page-generator from ~/path/to/repo

带选项的用法

/landing-page-generator from ~/path/to/repo --risk-banner --pricing-table

可用选项

选项描述默认值
--risk-banner在首屏上方添加醒目的警告/免责声明横幅false
--pricing-table包含定价对比部分false
--screenshots <path>截图文件夹路径./assets/
`--theme [darklight]`颜色主题变体
--search启用 Cmd+K 搜索true
--output <path>输出目录./[repo-name]-landing/

工作流程

第1步:仓库分析

读取并分析源仓库中的以下文件:

README.md        → 主要内容来源(标题、标语、功能、安装)
CHANGELOG.md     → 版本信息、最近更改
package.json     → 版本号、依赖项、元数据
VERSION          → 替代版本来源
docs/            → 额外文档页面
assets/          → 截图、图片
LICENSE          → 许可证类型(用于徽章)

第2步:内容提取映射

来源目标部分提取方法
README 标题/徽章Hero第一个 H1 + shield.io 徽章行
README TL;DRHero 标语标题后的第一段或引用块
README 功能功能网格H2/H3 部分 + 列表项
README 安装快速开始含 shell 命令的代码块
README 用法示例含示例的代码块
README FAQFAQdetails/summary 或 H3+P 模式
CHANGELOG最新动态最近的1-3个发布版本
assets/*.png截图画廊部分

第3步:部分生成

按顺序生成以下部分:

  1. 页眉(固定)

    • Logo/项目名称
    • 导航链接:功能、安装、FAQ
    • 操作:搜索(Cmd+K)、GitHub Star、主要 CTA
  2. 风险横幅(如果使用 --risk-banner)

    • 橙色/警告风格,位于首屏上方
    • 清晰可见的免责声明文本
    • 链接到详细的披露部分
  3. Hero 部分

    • 来自 README H1 的标题
    • 来自 TL;DR/第一段的标语
    • 统计徽章(版本、许可证、平台)
    • CTA:“快速开始”(主要)、“在 GitHub 上查看”(次要)
  4. 架构/概述(如果 README 中有图示)

    • ASCII 图示转换为样式化块
    • 或概述卡片
  5. 功能网格

    • 来自 README 功能的4-6个功能卡片
    • 图标 + 标题 + 描述模式
  6. 定价表(如果使用 --pricing-table)

    • 计划对比表格
    • 如果存在,包含倍数/用量表
  7. 截图画廊(如果存在资源)

    • 基于标签或轮播画廊
    • 来自替代文本的说明
  8. 快速开始部分

    • 一行安装命令(特色代码块)
    • 设置步骤
    • 第一个用法示例
  9. 风险披露(如果使用 --risk-banner)

    • 完整的免责声明部分
    • ToS 注意事项
    • 建议
  10. FAQ 部分

    • 来自 README FAQ 或常见问题生成
    • 可折叠的 details 模式
  11. 相关项目(如果 README 中有链接)

    • 指向依赖项/相关仓库的卡片
  12. 页脚

    • 快速链接
    • 许可证徽章
    • 版本信息
    • 作者/仓库链接

第4步:输出结构

[project-name]-landing/
├── index.html              # 主落地页
├── styles.css              # 完整样式表
├── search.js               # Cmd+K 搜索功能
├── search-data.js          # 搜索索引(FAQ、功能)
├── favicon.svg             # 生成或复制的图标
├── robots.txt              # SEO
├── CLAUDE.md               # 项目说明
├── README.md               # 落地仓库文档
├── assets/                 # 复制的截图
│   └── [从源复制]
└── .github/
    └── workflows/
        └── static.yml      # GitHub Pages 部署

第5步:验证检查点

在最终确定之前,请验证:

  • 所有部分在浏览器中正确渲染
  • 链接指向有效目标(GitHub 仓库、文档、安装命令)
  • 响应式布局在移动端(375px)、平板(768px)和桌面(1280px)宽度下正常工作
  • 无障碍:存在跳过链接、交互元素上有 ARIA 标签、颜色对比度通过 WCAG AA

技术栈

  • 无构建步骤:纯 HTML + CSS + JS
  • 搜索:从 CDN 惰性加载 MiniSearch,并有回退方案
  • 部署:通过 Actions 部署到 GitHub Pages
  • 样式:CSS 自定义属性、响应式、默认暗色主题
  • 无障碍:跳过链接、ARIA 标签、键盘导航

CSS 模式(来自已建立的落地页)

组件类

/* 按钮 */
.btn, .btn-primary, .btn-secondary, .btn-github-star, .btn-outline

/* 卡片 */
.feature-card, .comparison-card, .path-card

/* 布局 */
.container, .features-grid, .hero, .section

/* 工具类 */
.visually-hidden, .skip-link

CSS 变量

:root {
  --color-bg: #0d1117;
  --color-surface: #161b22;
  --color-border: #30363d;
  --color-text: #c9d1d9;
  --color-text-muted: #8b949e;
  --color-primary: #58a6ff;
  --color-success: #3fb950;
  --color-warning: #d29922;
  --color-danger: #f85149;
  --space-xs: 0.25rem;
  --space-sm: 0.5rem;
  --space-md: 1rem;
  --space-lg: 1.5rem;
  --space-xl: 2rem;
  --radius: 6px;
}

示例

用户:/landing-page-generator from ~/projects/my-project --risk-banner --pricing-table

输出:

创建 ~/projects/my-project-landing/,包含:

  • 展示多提供商路由器的完整落地页
  • 醒目的 ToS 风险横幅(橙色,位于首屏上方)
  • 提供商卡片(Anthropic、Copilot、Ollama)
  • 来自 README 的定价表
  • 截图画廊
  • 已准备好部署到 GitHub Pages

提示

  • 对于涉及法律/ToS 考虑的项目,始终包含 --risk-banner
  • 截图能显著提升落地页质量 - 确保 assets/ 目录已填充内容
  • 技能保留 README 的语言(英语/法语)
  • 检查生成的 FAQ - 可能需要进行自定义
  • 生成后测试响应式设计

参考

有关详细的模式文档,请参阅 references/landing-pattern.md。 有关可重用模板和代码片段,请参阅 assets/。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

相关技能