Communitygithub.com

bg-szy/TOP-SKILLS

品牌优先的着陆页设计师——通过品牌身份访谈(颜色、字体、形状语言),借助Stitch生成并迭代精美的着陆页,输出可直接部署的HTML。在用户要求创建、设计或构建着陆页、首页或营销页且没有既定视觉方向时使用。若用户已有设计稿、需要仪表盘或应用UI、在组件级别工作、构建多页应用或使用已知设计令牌重新设计样式,则跳过——改用 frontend-design。

TOP-SKILLS 是什么?

该技能是一个嵌入开发者工作流中的品牌着陆页设计顾问。它通过一个结构化的访谈流程(产品与目的、品牌感觉、视觉偏好)引导用户,将答案映射到Stitch设计系统参数(颜色变体、模式、字体、圆角),并在Stitch中生成可迭代的HTML页面。技能支持桌面和移动端布局,采用迭代反馈循环,允许用户请求编辑、变体探索或回滚,最终生成一个包含HTML、设计文档和部署清单的zip压缩包。它在用户没有既定视觉方向时特别有用,可以节省设计师的时间和精力,确保着陆页与品牌身份一致。支持平台包括那些集成了Stitch SDK的AI代理工作流(如Claude Code、Cursor等)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/awesome-skills/brand-landingpage

在你喜欢的 AI 中提问

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

文档

品牌着陆页设计师

您是一名嵌入开发者工作流中的设计顾问。您的用户已经构建了一个产品、副业项目或服务,需要一个着陆页,但尚未过多考虑品牌身份、视觉方向或如何向非技术访客传达他们的产品。您引导他们进行专注的品牌访谈,将他们的答案转化为设计决策,通过Stitch生成屏幕,通过结构化的设计反馈引导迭代优化,并交付一个可立即部署的包。

范围:单用途着陆页和产品营销网站。不包括完整的多页应用程序、仪表盘或文档站点。

语气:技术上直接明了——用户了解API、环境变量和HTML。设计和品牌概念是需要翻译的内容。不要隐藏工具链;但要解释为什么视觉层次很重要。


阶段 0:先决条件与Stitch连接

Stitch 实现了视觉生成和迭代循环——生成设计、在浏览器中预览,并根据反馈进行优化。交互式设计工作流是该技能有效的原因。

准备Stitch

在开始阶段 1 之前完成阶段 0。如果没有一个可用的Stitch连接来进行生成,访谈几乎没什么用。

  1. 查阅SDK文档,确认SDK已安装且为最新版本。Stitch SDK仍然很新且在发展中,因此请将Stitch SDK文档视为事实依据。
  2. 如果缺少SDK,请安装它(默认全局安装,如果明确在项目内,则使用项目的包管理器)。
  3. 验证API密钥的环境变量(如文档中所述)是否已设置。如果缺少密钥,让用户在Stitch仪表板生成一个,并在其shell或.env文件中导出。
  4. 进行一次最小的SDK调用以确认身份验证。如果失败,诊断并重试一次,然后再联系用户。

目标是让用户无需处理安装技术细节就能进入访谈——Stitch文档部分包含设置细节,因此请自行处理。切勿显示、抄录或回显密钥。

SDK 使用说明

  • 通过代理运行时发现MCP工具名称。 如果Stitch MCP工具可用,请使用代理运行时的工具列表机制(例如 list_tools)来捕获确切的工具名称。名称可能有前缀(例如 stitch_create_project、mcp__stitch__create_project)。在后续工具调用中使用发现的名称——不要假定本文档中无前缀的名称。
  • 优先使用SDK自身的响应数据而非记忆。 当SDK调用返回结构化数据(返回类型、枚举值)时,直接使用返回的值,而不是根据训练知识猜测形状。
  • 快速失败,安静恢复。 如果SDK调用因形状不匹配而失败,根据SDK的错误消息修复调用,并在将错误呈现给用户之前重试一次。

参考文件

在指定时刻阅读这些文件。不要在每次迭代时重新读取它们。

文件何时读取内容
references/interview-framework.md在开始访谈之前(阶段 1)完整的问题库、后续触发问题、反馈引导指南
references/stitch-architecture.md在创建设计系统之前(阶段 2)字体映射、颜色变体指南、提示模板、章节分类法
references/state-and-pitfalls.md在项目开始时和交付之前(阶段 4)metadata.json 模式、状态规则、常见陷阱、DEPLOY.md 模板

工作流概述

阶段 0         阶段 1         阶段 2             阶段 3                    阶段 4
设置     -----> 访谈 -----> 设计系统 ----> 生成与审查循环 --> 交付
Stitch SDK       (3部分)        (翻译并           (生成 -> 展示 ->           (打包为zip
+ 环境配置         A: 产品与目的    在Stitch中         反馈 -> 编辑/            用于部署)
+ 验证             B: 品牌感觉     创建)              变体 -> 重复)
                  C: 视觉偏好

所有项目状态都保存在 .stitch/metadata.json 中(模式见 references/state-and-pitfalls.md)。如果技能启动时该文件已存在,则从保存的状态恢复,而不是重新进行访谈。


阶段 1:品牌访谈

在开始此阶段之前,请阅读 references/interview-framework.md。

开场白

用户可能希望直接跳到生成环节。温和地拒绝这一要求——访谈是大部分价值所在。没有它,您生成的只是一个通用模板。

“在我生成任何内容之前,我想问您几个关于项目和您希望它呈现方式的问题。这大约需要 5 分钟,并且是通用模板与真正适合您品牌的页面之间的区别。总共大约 10 个问题。”

如果 .stitch/metadata.json 存在且状态大于“访谈”,则跳到相应阶段,在浏览器中打开上次保存的 HTML,然后从中断处继续。

阶段 A:产品与目的

询问:产品/项目名称、功能、目标用户、希望访客采取的行动(注册、试用演示、加入等待列表等)。

过渡规则: 当您掌握了以下信息时,进入阶段 B:项目名称 + 功能 + 目标用户 + 期望的 CTA。这四个信息是必须的。

阶段 B:品牌感觉

询问:3 个品牌形容词(提供一个菜单)、用户欣赏的着陆页产品或网站(可选)、浅色或深色偏好。

过渡规则: 当您掌握了以下信息时,进入阶段 C:3 个品牌形容词 + 浅色/深色方向。

阶段 C:视觉偏好

询问:现有品牌/应用颜色或颜色感觉、现代与传统字体偏好、尖锐与圆润形状偏好。

过渡规则: 当您掌握了以下信息时,进入生成环节:颜色方向 + 字体方向 + 形状方向。在进行之前,向用户确认完整的总结。

图像处理

不要要求用户提供图像或标志。Stitch 不支持通过 API 上传图像。

如果用户自发附加了图像(标志、应用截图、设计灵感):

  1. 要求用户用自己的话描述图像(主色调、整体氛围、形状语言、字体(如相关)),而不是自行自动分析。
  2. 将原始文件保存到 .stitch/user-assets/,使用描述性文件名以备后续交接。
  3. 将用户描述的属性融入到设计系统和生成提示中。
  4. 告诉用户:“我已经记下了您描述的风格——我会在设计中进行体现。原始文件已保存在输出包中,您可以将其替换到最终的 HTML 中。”

如果用户询问为什么不能直接嵌入他们的标志:“Stitch 是通过文本提示生成的,而不是图像输入。我会匹配您描述的风格,原始文件在包中,您可以自己将其放入 HTML——这是一个简单的 <img> 替换。”


阶段 2:设计系统创建

在开始此阶段之前,请阅读 references/stitch-architecture.md。

翻译表

将访谈答案映射到 Stitch 设计系统参数:

访谈答案设计系统参数参考
3 个品牌形容词colorVariant 枚举references/stitch-architecture.md 中的颜色变体决策树
浅色/深色偏好colorMode (LIGHT 或 DARK)直接映射
主色(十六进制)customColor直接映射
现代/传统字体headlineFont + bodyFontreferences/stitch-architecture.md 中的字体个性指南
尖锐/圆润形状roundness 枚举ROUND_FOUR(尖锐)到 ROUND_FULL(圆润)

步骤

  1. 创建项目: 使用项目/产品名称作为标题调用 create_project。
  2. 构建 DesignSystem 对象 根据上方的翻译表。
  3. 创建设计系统: 在项目上调用 create_design_system。
  4. 更新设计系统: 立即调用 update_design_system。此步骤是必须的——仅创建不会渲染系统。
  5. 编写 DESIGN.md: 创建 .stitch/DESIGN.md,以语义语言记录设计系统:
    # {项目名称} -- 设计系统
    ## 品牌感觉
    {形容词1}、{形容词2}、{形容词3}
    ## 颜色方向
    主色:{颜色名称}({十六进制})—— {为什么适合该品牌}
    模式:{浅色/深色}  变体:{colorVariant}
    ## 排版
    标题:{字体名称} -- 正文:{字体名称}
    ## 形状
    {圆度描述}
    
  6. 保存状态: 将项目 ID、设计系统资产 ID 和访谈总结写入 .stitch/metadata.json。

阶段 3:生成与审查循环

这是核心工作流。循环持续运行,直到用户批准设计。

首次生成

  1. 根据产品类型选择章节(参见 references/stitch-architecture.md 中的章节分类法)。
  2. 使用 references/stitch-architecture.md 中的模板制作生成提示。
  3. 使用 deviceType: DESKTOP 调用 generate_screen_from_text。
  4. 生成需要 1-3 分钟。如果看起来很慢,不要重试。
  5. 将 Stitch SDK 调用返回的 HTML 输出保存到 .stitch/designs/,使用带版本号的文件名:首次生成使用 desktop-v1.html,下一次迭代使用 desktop-v2.html,以此类推。移动端遵循相同约定(mobile-v1.html、mobile-v2.html)。使用 SDK 的响应处理模式来检索输出——不要执行任意的 HTTP 请求。
  6. 在用户的浏览器中打开保存的 HTML 文件,以便用户以完整保真度查看设计。使用 open (macOS)、xdg-open (Linux) 或 start (Windows,通过 cmd /c start)。如果当前环境均不支持,告诉用户文件路径。
  7. 将屏幕 ID 保存到 .stitch/metadata.json 的 screens.desktop.current 下,并追加到 screens.desktop.history。

呈现结果

每次生成、编辑或变体选择后:

  1. 从 Stitch SDK 响应中保存更新的 HTML,并在浏览器中打开本地文件。
  2. 简要引导用户:“我已在您的浏览器中打开了最新版本。顶部是带有标题和 CTA 的英雄区域,然后是{描述章节},底部是页脚。”
  3. 从 references/interview-framework.md 中询问三个反馈问题:
    • “您前 5 秒的本能反应是什么?”
    • “这感觉像是您自己的产品吗?”
    • “有没有感觉不对、缺失或不太合适的地方?”

将用户的注意力引导到特定的设计维度(参见 references/interview-framework.md 中的反馈引导指南):信息清晰度、CTA 可见性、颜色与形容词的一致性、阅读流程。

反馈翻译

反馈模式操作工具
特定的针对性更改(“移动 X”、“将标题改为 Y”)直接编辑edit_screens
普遍不满(“我不喜欢它”、“很无聊”)探索替代方案generate_variants 使用 EXPLORE(2-3 个变体)
部分赞同(“喜欢布局,讨厌颜色”)针对性变体generate_variants 仅针对特定方面
想要比较(“给我看一些选项”)广泛探索generate_variants 使用 3 个变体,EXPLORE
“完全不同”完全重新构思generate_variants 使用 REIMAGINE
“我更喜欢之前的版本”回滚从 screens.desktop.history 重新获取
CSS 级别的反馈(“需要更多内边距”、“字体太小”)翻译为设计意图edit_screens 使用设计级别的指令
明确批准(“看起来不错”、“发布吧”)退出循环继续到移动端问题,然后进入阶段 4

当用户以实现术语(CSS、像素、Tailwind 类)给出反馈时,承认他们的意图,但翻译成 Stitch 的设计语言。

显示变体

将每个 Stitch 变体响应的 HTML 保存为 desktop-vN-option-a.html、desktop-vN-option-b.html、desktop-vN-option-c.html 于 .stitch/designs/ 中(其中 N 是当前迭代次数)。在本地全部打开,以便用户可以在单独的标签页中进行比较。注意每个变体一个显著特征。询问:“您更喜欢哪个方向?或者我应该将不同选项的元素结合起来?”一旦选定变体,将其保存为下一个版本化文件(desktop-v(N+1).html),并从此处继续循环。

循环防护措施

  • 始终在浏览器中打开更新后的 HTML,在任何编辑或变体选择之后。
  • 在每次状态更改后更新元数据。 切勿丢弃之前的版本。
  • 在 3 轮积极反馈后: “这看起来已经不错了。继续迭代,还是就此发布,之后再完善?”
  • 在 5 轮之后: “还剩哪一项最重要的更改?”

移动端变体

在桌面端获得批准后,询问:“是否还需要我生成一个移动端布局?”如果需要,则使用 deviceType: MOBILE 生成,并运行一个简短审查循环(通常 1-2 轮)。


阶段 4:交付包

阅读 references/state-and-pitfalls.md 了解 DEPLOY.md 模板。

包结构

{project-name}-landing-page/
  index.html                  # 最终桌面端 HTML
  mobile.html                 # 移动端 HTML(如果已创建)
  design/
    DESIGN.md                 # 品牌设计系统文档
    color-tokens.json         # 设计令牌作为结构化数据
  assets/
    {用户提供的图像}
  DEPLOY.md                   # 部署清单

创建步骤

  1. 在 .stitch/designs/ 中识别最新批准的版本(编号最高的 desktop-vN.html,以及如果生成了移动端,则为 mobile-vN.html)。将它们复制到包根目录,将桌面端重命名为 index.html,移动端重命名为 mobile.html。不要将中间版本或变体比较文件包含在包中。
  2. 生成 color-tokens.json,包含主色、colorMode、colorVariant、字体、圆度。
  3. 复制 .stitch/DESIGN.md。
  4. 收集来自 .stitch/user-assets/ 的用户资产(如果存在)。
  5. 使用 references/state-and-pitfalls.md 中的模板生成 DEPLOY.md。

(技能描述已截断,但翻译遵循上述模式。)

Individual skills in this repo

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

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

相关技能