Communitygithub.com

Landing Page Generator / 著陸頁產生器

從任何儲存庫產生完整、可部署的著陸頁。適用於為開源專案建立首頁、建構專案網站、將 README 轉換為行銷頁面,或在多個儲存庫中標準化著陸頁。

著陸頁產生器 是什麼?

此技能旨在從任何 GitHub 儲存庫自動分析其文件與結構,生成一個完整、可直接部署的靜態著陸頁。它會讀取 README.md、CHANGELOG.md、package.json 等檔案,並將內容映射至 Hero、功能、安裝、FAQ 等區塊,最終產出包含 HTML、CSS、JS 的靜態網站。支援額外選項如風險橫幅與定價表,並內建 GitHub Actions 工作流程以便直接部署至 GitHub Pages。適用於開源專案首頁、行銷展示頁面或跨專案標準化著陸頁的情境。

相容平台✓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 [dark|light]色彩主題變體dark
--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. 頁首(固定)

    • 標誌/專案名稱
    • 導覽連結:功能、安裝、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. 螢幕截圖圖庫(如果 assets 目錄存在)

    • 分頁或輪播圖庫
    • 來自替代文字的說明
  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 並有備用方案
  • 部署:透過 GitHub 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.

相關技能