← ClaudeAtlas

homepage-craftlisted

为开源项目生成优美的主页:扫描仓库(manifest、README、截图、git 元信息), 产出一个可直接发布到 GitHub Pages 的单文件 HTML landing page(docs/index.html)。 自动探测并编排已安装的设计类 skill(frontend-design / ui-ux-pro-max / superdesign) 提升视觉质量——ui-ux-pro-max 出设计系统,frontend-design 管实现美感; 一个都没装时退回内置设计基线(references/design-baseline.md),不阻塞主流程。 生成后可选自动部署到 GitHub Pages(commit + push + gh 开启 Pages),先询问再动手; 发布策略由用户决定:随 main 分支 + /docs 同提交同步,或隔离到独立 gh-pages 分支。 部署成功后可选把公开地址回填进项目——README 挂一行链接、仓库 Website 字段填地址, 两项分开让用户勾选,同样先问再做。 触发:"给项目生成主页"、"做一个 landing page"、"生成项目官网"、"GitHub Pages 首页"、 "project homepage"、"把 README 变成网页"、"开源项目展示页"、"给我的库做个介绍页"、 "把主页部署上线"(配合已生成的主页)、"主页地址加到 README"、"设置仓库 Website"。 不要在以下情况使用: - 要写 / 改 README.md 本身(Markdown 文档,不是网页)→ 用 readme-craft(如已安装);本 skill 只负责往 README 回填一行主页链接 - 只要一张 README 顶部 banner 图 → 用 readme-banner(如已安装) - 通用前端开发或任意 UI 设计(不是"仓库 → 主页"这条流水线)→ 直接用 frontend-design 等设计 skill - 项目已有 VitePress / Docusaurus / MkDocs 文档站,且用户想往文档站里加页 → 按该框架惯例写
uwakeme/wake-skills · ★ 1 · Web & Frontend · score 71
Install: claude install-skill uwakeme/wake-skills
# homepage-craft 把一个开源仓库变成一页拿得出手的主页:素材全部来自仓库本身(README、manifest、截图、git 元信息),产物是一个单文件 HTML,双击能开、推到 GitHub Pages 就能发布。视觉质量优先借力环境里已装的设计类 skill,本 skill 负责的是"仓库 → 内容 → 页面"这条流水线和发布可用性。 ## 设计原则(贯穿整个 procedure) | 原则 | 含义 | 反例 | | --- | --- | --- | | **内容真实** | 页面上一切事实(功能、数字、链接、截图)都来自仓库素材,拿不到的就不写 | 编造 "10k+ users"、放 stock 占位图、写仓库里不存在的功能 | | **单文件零构建** | 一个 `index.html` 装下全部 CSS/JS,无 npm、无构建步骤,file:// 直接打开 | 产物需要 `npm install && build` 才能看 | | **美感有出处** | 设计决策来自 companion skill 或内置基线,并在报告里说明用了哪条路径 | 不声明来源地随手套一个紫色渐变模板 | | **发布即可用** | OG meta、favicon、JSON-LD、相对路径全配齐,推到 GitHub Pages 就是完成态 | 分享出去没有社交预览卡片;图片路径出了 docs/ 就 404 | 风格基线:**像一个头部开源项目的官网,不是像模板市场的 demo 页。** --- ## Inputs to collect 按需读取,不需要全部问用户: - **项目路径**:默认当前工作目录;用户给 GitHub URL 时走远程模式(见 Step 2) - **输出位置**:默认 `<project-root>/docs/index.html`(GitHub Pages 的 /docs 源约定);`docs/` 被文档框架占用时改用 `homepage/index.html`(见 Failure handling) - **页面语言**:默认跟随主 README 的语言,不问;用户指定了其他语言按用户的来 - **风格偏好**(可选):用户主动说了("暗色"、"极简")就记录;没说且有 companion 设计 skill 时交给它决定;两者都没有时,从基线三方向里按项目类型选,不追问(见 Step 3) - **部署意向**:不预设、不提前问——Step 7 生成完毕后再询问;用户一开始就明确说"部署到 GitHub Pages"的,Step 7 免询问直接走 - **发布策略**:同样在 Step 7 与部署意向一起问(A:main + /docs;B:独立 gh-pages 分支),不预设默认偏好;用户在需求里指定了("走 gh-pages"、"别动 main")就跳过询问 - **地址回填意向**:也不提前问——Step 8 拿到公开地址后一次性问(README 挂链接 / 仓库 Website 字段 / 两项都做 / 都不做),让用户自己勾选 --- ## Procedure ### Step 1 — 扫描项目,收集素材 读取根目录列表和关键 manifest,确定 name、version、description、license、homepage/repository 字段。manifest 类型对照表与 readme-craft 一致(package.json / pyproject.to