跳转到使用指南
brand-landingpage作者 Seth Hobson

Brand Landing Page Skill.

一个用于 UI 设计的 Claude Code 和 Codex skill,先进行品牌识别访谈,然后通过 Stitch 生成并迭代着陆页。

  • Web & UI
  • UI 代码
wshobson/agents · plugins/brand-landingpage/skills/brand-landingpage/SKILL.mdSKILL.md
--- name: brand-landingpage description: Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at … --- ## Phase 0: Prerequisites & Stitch Connection ## Phase 1: Brand Interview ## Phase 2: Design System Creation ## Phase 3: Generate & Review Loop ## Phase 4: Delivery Bundle ## Stitch Documentation
前言和章节标题读取自上游文件,时间 2026-09-14 · 完整内容 15,626 字符

01 功能说明

brand-landingpage Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

一个以品牌为先的落地页设计器:进行三部分访谈(产品目的、品牌感受、视觉偏好),将回答转化为 Stitch 设计系统(将形容词映射到 colorVariant,字体映射到 headlineFont/bodyFont,形状映射到 roundness),生成桌面端和移动端界面,通过结构化反馈(变体、编辑、回滚)引导迭代优化,并交付一个可部署的产物包,包含带版本号的 HTML、DESIGN.md、颜色 token 和 DEPLOY.md。

适用于构建单一用途落地页或产品营销网站、且尚无明确视觉方向的用户。不适用于仪表盘、多页面应用、组件级工作,或已有设计稿的用户。

它产出什么

  • 可部署的 zip 产物包,包含 index.html(桌面端)、mobile.html(如已生成)、DESIGN.md、color-tokens.json、用户资源以及 DEPLOY.md 检查清单
  • DESIGN.md,记录设计系统内容,包括品牌感受、附带十六进制值和理由的色彩方向、排版选择,以及形状圆润度说明
  • color-tokens.json,包含结构化的设计 token:主色、colorMode、colorVariant、字体、roundness
  • DEPLOY.md 部署检查清单,根据 references/state-and-pitfalls.md 中的模板生成
查看示例提示词 ↗

工作方式

  1. 01
    验证 Stitch SDK 与环境

    在开始访谈之前,该 skill 会在 SDK 缺失时进行安装,验证 API key 环境变量是否已设置,并进行一次最小化的 SDK 调用以确认鉴权。

  2. 02
    运行三部分品牌访谈

    A 阶段获取产品名称、产品功能、目标用户及期望的 CTA。B 阶段获取 3 个品牌形容词以及浅色/深色偏好。

  3. 03
    将访谈内容转化为 Stitch 参数

    该 skill 使用一张转换表,将品牌形容词映射到 colorVariant 枚举,将浅色/深色映射到 colorMode,将字体偏好映射到 headlineFont 和 bodyFont,将锐利/圆润映射到 roundness 枚举。

  4. 04
    生成界面并在浏览器中打开

    该 skill 以 deviceType DESKTOP 调用 generate_screen_from_text,将返回的 HTML 保存为 .stitch/designs/ 目录下的 desktop-v1.html,并使用特定操作系统的命令在本地打开它。

  5. 05
    在反馈循环中迭代

    每次生成后,该 skill 会提出三个反馈问题,将用户反馈转化为用于针对性修改的 edit_screens 调用,或用于探索的 generate_variants 调用,并以递增的文件名保存新版本。

  6. 06
    交付部署包

    该 skill 会创建一个 zip 文件,其中包含重命名为 index.html 的最终 HTML、(如已生成)mobile.html、记录品牌系统的 DESIGN.md、color-tokens.json、用户资产,以及一份 DEPLOY.md 检查清单。

02 找到适合场景

何时使用 brand-landingpage Skill

当工作是此类 UI 设计时,在 Claude Code 或 Codex 中使用 brand-landingpage skill。适用范围和限制取自该 skill 自己的文件。

适合场景

  • 用户要求创建、设计或搭建一个落地页、主页或营销页面,且尚未确立视觉方向
  • 用户已构建了一个产品、副业项目或服务,需要一个落地页,但尚未对品牌形象或视觉方向有过多考虑
  • 单一用途的落地页和产品营销网站

了解边界

  • 用户有一份设计稿
  • 用户需要一个仪表盘或应用 UI
  • 用户正在组件层面进行工作
  • 用户正在构建多页面应用,或使用已知的设计 token 进行重新设计(请改用 frontend-design)

需要提供的信息

  • 产品名称与用途产品的功能、目标用户是谁,以及访问者应采取的行动(注册、试用演示、加入候补名单)。
  • 三个品牌形容词该 skill 提供一份可供选择的形容词菜单。从阶段 B 进入阶段 C 是必需的。
  • 浅色或深色偏好直接映射到 Stitch 设计系统中的 colorMode 参数(LIGHT 或 DARK)。
  • 色彩方向现有品牌或应用颜色的十六进制值;如果尚无既定色板,则给出一种色彩感觉。映射到 customColor 参数。
  • 字体与形状偏好现代与传统字体偏好映射到 headlineFont 和 bodyFont。

03 Skill 内部

brand-landingpage Skill 赋予 Claude Code 和 Codex 的规则

SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

  1. 绝不显示 API 密钥

    该 skill 在验证环境或诊断身份验证失败时,绝不能显示、转录或回显 Stitch API 密钥。

  2. 不索取图片

    该 skill 不得要求用户提供图片或徽标,因为 Stitch 不接受通过 API 上传图片。

  3. 按顺序为 HTML 文件命名版本

    将首次生成的 HTML 保存为 desktop-v1.html,下一次迭代保存为 desktop-v2.html,依此类推。

  4. 始终在浏览器中打开更新后的 HTML

    每次生成、编辑或选择变体后,skill 必须保存 Stitch 响应中更新后的 HTML,并在用户浏览器中打开该本地文件。

  5. 三轮正向反馈后提示交付

    经过三轮正向反馈后,skill 应该询问:“看起来已经很扎实了。继续迭代,还是先交付、之后再打磨?”

  6. 四个不可协商的访谈答案

    skill 必须在从阶段 A 进入阶段 B 之前,收集项目名称、产品功能、目标用户和期望的 CTA。这四项是不可协商的。

  7. 生成失败后不要立即重试

    如果生成失败,不要立即重试。使用 get_screen 或 list_screens 检查是否已异步完成。

04 投入使用

在 Claude Code 或 Codex 中安装 brand-landingpage

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 brand-landingpage 添加到 Claude Code、Codex 或您的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/wshobson/agents --skill brand-landingpage

针对 plugins/brand-landingpage/skills/brand-landingpage/SKILL.md 的通用 skills CLI 形式;该仓库可能会说明自己的路径。

给 Skill 一个首次 UI 设计任务

SKILL.md 不包含示例提示;此启动器根据目录一行摘要编写。将任务行替换为你的实际 brief。

Starter prompt
Use the brand-landingpage skill on the material I attach. What the skill should do here: Brand-identity interview first, then generates and iterates a landing page through Stitch. Rules: do not invent copy, data or brand assets. State your plan first, then produce the result and tell me what to check.

来源:根据目录一行用途编写的启动器提示(不是来自 SKILL.md)。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 使用操作系统专用命令(macOS 上的 open、Linux 上的 xdg-open、Windows 上的 start)在用户浏览器中打开已保存的 HTML 文件,以查看完整还原效果
  • 提出三个反馈问题:前 5 秒的直观感受、这是否像他们自己的产品,以及是否有任何感觉不对或缺失的地方
  • 引导用户关注特定的设计维度:信息清晰度、CTA 可见性、颜色与其形容词的一致性,以及阅读流程
  • 在恢复会话时,验证 .stitch/metadata.json 是否存在,并包含项目 ID、设计系统资产 ID、访谈摘要和屏幕历史
  • 遵循 DEPLOY.md 中的部署检查清单,涵盖托管、域名设置、分析工具和图片替换

在 OpenDesign 中,通过其 SKILL.md 链接导入 brand-landingpage:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Repository
github.com/wshobson/agents 分支 main
Skill 文件
plugins/brand-landingpage/skills/brand-landingpage/SKILL.md 验证时记录的内容校验和;提交 4236bb9
License
MIT 来自 LICENSE。
仓库星标数
39,635 2026-09-14 对整个 wshobson/agents 仓库的 GitHub 快照,该仓库在此目录中包含 18 个 skills。不是 brand-landingpage 的评分或使用次数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 阶段 0:前提条件与 Stitch 连接在开始访谈之前,验证 SDK 安装、API 密钥环境变量,并进行最小化测试调用
  2. 参考文件列出工作流中何时读取 interview-framework.md、stitch-architecture.md 和 state-and-pitfalls.md
  3. 工作流概览四个阶段:设置、三部分访谈、设计系统转换、生成与审查循环、交付包
  4. 阶段 1:品牌访谈三个部分:产品目的、以形容词表达的品牌感觉、关于颜色、字体和形状的视觉偏好
  5. 阶段 2:设计系统创建使用映射表将访谈答案转换为 Stitch 参数,创建并更新设计系统,编写 DESIGN.md
  6. 阶段 3:生成与审查循环生成桌面端屏幕,在浏览器中打开,通过三个问题收集反馈,通过编辑或变体进行迭代
  7. 阶段 4:交付包将最终 HTML、DESIGN.md、颜色 token、用户资产和 DEPLOY.md 检查清单打包成带版本号的 zip
  8. Stitch 文档链接到 stitch-design.ai 上的 SDK 使用文档和 DESIGN.md 示例
  9. 恢复与错误处理从 metadata.json 加载状态,在恢复时处理生成失败、速率限制和已过期的项目
Skill 自身的描述
"品牌优先的落地页设计器——进行品牌识别访谈(颜色、排版、形状语言),然后通过 Stitch 生成并迭代精美的落地页,提供可部署的 HTML。当用户要求创建、设计或构建落地页、主页或营销页面且没有既定的视觉方向时使用。当他们有设计稿、需要仪表盘或应用 UI、在组件层面工作、构建多页应用或使用已知 design tokens 重新设计时跳过——改用 frontend-design。"

来自 SKILL.md 的 front-matter 描述。完整文件约 15,626 字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 brand-landingpage Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

我可以提供自己的 logo 或产品截图吗?

Stitch 根据文本 prompt 生成内容,不接受通过 API 上传图片。如果你附上一张图片,skill 会要求你用自己的话描述它的主色调、氛围和形状语言,然后将这些属性融入设计中。

你的原始文件会保存在 bundle 中,因此你可以通过简单的 img 标签替换,把它换入最终的 HTML 中。

为什么我需要经过访谈,而不能直接跳到生成环节?

访谈环节创造了大部分价值。没有它,结果只会是一个通用模板。

访谈大约需要 5 分钟,会收集产品用途、目标用户、品牌形容词和视觉偏好,skill 会将这些内容转化为一个真正契合你品牌的设计系统,而不是一个千篇一律的输出。

最终我能得到什么?

一个可直接部署的 zip bundle,其中包含重命名为 index.html 的最终桌面版 HTML、如果你要求了移动端变体则包含 mobile.html、记录你的品牌设计系统的 DESIGN.md、包含结构化 token 的 color-tokens.json、任何用户提供的资源,以及带部署清单的 DEPLOY.md。所有中间版本和状态都保存在 .stitch/ 中以供参考。

Brand Landing Page

在真实 UI 设计任务上运行 brand-landingpage。

下载 OpenDesign,从 SKILL.md 链接导入 brand-landingpage,粘贴上述提示词,在查看结果前先阅读计划。

终端
npx skills add https://github.com/wshobson/agents --skill brand-landingpage

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows