Communitygithub.com

VRIL-LABS/skill-jam

构建具有卓越品质的生产级网站和 Web 应用。根据框架(Next.js、React Native、原生 HTML)自动路由到正确的指导。涵盖设计令牌、排版、动效、布局、可访问性和部署。

skill-jam 是什么?

本技能是构建专业级网站和 Web 应用的全面指南,旨在帮助开发者避免常见的“AI 生成”泛泛风格,确保每个设计选择(字体、颜色、动效、布局)都经过深思熟虑。它支持多种框架的自动路由:检测到 Next.js 或 React Native 时加载对应的专项文件,处理纯 React(Vite/CRA)或原生 HTML/JS 项目。技能的核心工作流包括:根据项目类型(信息型站点、Web 应用、浏览器游戏)加载领域特定的设计指导,随后使用共享文件(设计令牌、排版规则等)实现统一的 Nexus 设计系统。此外,强制集成了 Playwright 交互 QA 流程,要求每次部署前通过截图对比进行视觉验证,并自动生成自定义 SVG Logo 和页脚归属。最终通过 `deploy_website()` 函数将项目发布为静态 HTML/CSS/JS 包到 S3。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/VRIL-LABS/skill-jam/tree/HEAD/skills/website-building

在你喜欢的 AI 中提问

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

文档

网站构建

构建具有卓越品质、可避免泛泛“AI 生成”美学的生产级网站。每一个选择——字体、颜色、动效、布局——都必须是经过深思熟虑的。以静态 HTML/CSS/JS 包的形式部署到 S3。

本技能涵盖 Web 项目的所有内容。 当通过 load_skill("website-building") 加载时,所有文件都会被复制到 workspace/skills/website-building/。根据项目类型,按需读取子文件。对于 Web 应用程序,请加载子技能:load_skill("website-building/webapp")。

通用设计原则(色彩哲学、默认调色板、字体选择)通过 design-foundations 与其他技能共享。本技能的共享文件通过 Web 特定的实现(CSS 变量、响应式令牌、基础样式表)扩展了这些基础。您无需单独加载 design-foundations——shared/ 中的 Web 特定版本已经足够全面。

使用完整的路径进行读取,例如 skills/website-building/shared/01-design-tokens.md。


框架检测路由器

在按项目类型路由之前,先识别框架:

信号框架操作
package.json 包含 "next" 依赖项 OR next.config.* 存在Next.js首先读取 skills/website-building/nextjs/SKILL.md
package.json 包含 "react-native" 或 "expo" 依赖项React Native首先读取 skills/website-building/react-native/SKILL.md
package.json 仅包含 "react"(Vite/CRA/Remix)React(非 Next)使用标准 Tailwind 指导下的 skills/website-building/webapp/SKILL.md
没有 package.json,只有 .html 文件原生 HTML/CSS/JS继续使用标准共享文件

框架特定文件提供:

  • 确切的设置命令和版本号
  • 框架特定的 Tailwind 集成(Next.js 使用 v4,RN 使用 NativeWind)
  • 特定于框架的路由、数据获取和组件模式
  • 框架部署指南

读取框架文件后,返回此技能的“项目类型路由”(下方),以加载领域特定的设计指导(信息型/Web 应用/游戏)。


项目类型路由

第 1 步:识别项目类型并加载领域特定的指导:

项目类型操作示例
信息型站点read skills/website-building/informational/informational.md个人网站、作品集、编辑/博客、小型企业、落地页
Web 应用程序load_skill("website-building/webapp")SaaS 产品、仪表盘、管理后台、电商、品牌体验
浏览器游戏read skills/website-building/game/game.md + skills/website-building/game/game-testing.md2D Canvas 游戏、Three.js/WebGL、HTML5 游戏、交互式 3D 体验

第 2 步:读取共享文件——首先读取 skills/website-building/shared/01-design-tokens.md 和 skills/website-building/shared/02-typography.md(所有项目类型的强制性步骤,包括 webapp)。这些文件建立了 Nexus 设计系统默认值以及普遍应用的排版规则。对于 Web 应用和仪表盘,跳过下方标记为 † 的文件——这些文件包含已预设在全栈模板中的实现细节。

如果用户只说“网站”或“站点”而没有提供细节,请询问类型或默认使用信息型。


子文件参考

共享文件 (shared/) —— 每个项目

文件涵盖内容加载时机
shared/01-design-tokens.md字号比例、间距、Nexus 调色板、base.css始终
shared/02-typography.md字体选择、配对、加载、黑名单始终
shared/04-layout.md空间构成、响应式、移动优先始终 †
shared/05-taste.md骨架屏加载器、空/错误状态、打磨始终
shared/08-standards.md可访问性、性能、反模式始终
shared/09-technical.md项目结构、沙箱、部署、检查清单始终 †
shared/pplx_attribution.html用于 <head> 的归属信息块始终 †
shared/03-motion.md滚动动画、Motion 库、GSAP SVG 插件、悬停/光标效果当需要动画时
shared/06-css-and-tailwind.mdTailwind CSS v3、shadcn/ui、现代 CSS当使用 Tailwind 时
shared/07-toolkit.mdCDN 库、React、Three.js、图标、地图、SVG 模式/滤镜、esm.sh当选择库时
shared/10-charts-and-dataviz.mdChart.js、Recharts、D3、关键绩效指标、迷你图当需要数据可视化时
shared/11-web-technologies.md框架版本、浏览器兼容性当检查兼容性时
shared/12-playwright-interactive.md持久化 Playwright 浏览器 QA、截图、视觉测试当测试时
shared/19-backend.mdFastAPI/Express/Flask 服务器、WebSocket、SSE、端口转发当需要后端时
shared/20-llm-api.mdLLM 聊天、图像/视频/音频生成、转录——模型、凭据、SDK 辅助工具当站点使用 AI/LLM API 时

所有路径均相对于 skills/website-building/。

† 对于 webapp 和仪表盘应跳过——这些实现细节已预设在全栈模板中。设计令牌和排版不会跳过——它们为所有项目类型提供了权威的设计系统默认值和字体选择指导。

领域特定文件 —— 加载其中一个

文件何时加载
load_skill("website-building/webapp")SaaS、仪表盘、管理后台、电商、品牌体验(带全栈模板的子技能)
webapp/dashboards.md仪表盘或数据密集型界面(与 webapp 配套)
informational/informational.md个人网站、作品集、编辑类、小型企业、落地页
game/game.md浏览器游戏、Three.js、WebGL、交互式 3D
game/2d-canvas.md2D Canvas 游戏(与 game.md 配套)
game/game-testing.md任何浏览器游戏——与 game.md 一同加载

交互式 QA: 读取 skills/website-building/shared/12-playwright-interactive.md 以了解如何使用 Playwright 进行持久的浏览器自动化(截图、功能测试、视觉 QA)。对于游戏测试是必需的,对于任何复杂的站点也是有用的。


工作流程

  1. 设计方向:明确目的,选择美学方向
  2. 构建:逐页构建网站,通过 Playwright 进行截图 QA
  3. 发布:deploy_website() 返回公开 URL

使用每种工具

  • 先做调研。 在设计之前,搜索网络上的参考站点、趋势和竞争对手示例。浏览获奖的特定站点类型示例。获取用户提供的任何 URL。
  • 慷慨地生成真实资产。 为主图、章节插图、编辑性特色视觉、背景氛围图等生成图像——而不仅仅是单个主图。每个长篇页面都应该通过生成的图像保持视觉节奏,这些图像要符合站点的艺术方向。不要使用占位符。为每个项目生成自定义 SVG 标志(见下文)——SVG 仅用于标志,除非用户特别请求 SVG 输出。保存指导方向的 Web 参考图像。
  • 通过 Playwright 截图。 读取 skills/website-building/shared/12-playwright-interactive.md,以桌面端(1280px+)和移动端(375px)进行截图。与参考图进行比较。这是强制性的,而非可选。请参见下方的视觉 QA。
  • 直接编写生产级代码。 HTML、CSS、JS、SVG。使用 bash 处理构建工具和文件处理。

SVG 标志生成

每个项目都会获得一个自定义的内联 SVG 标志。绝不要用样式化的文本标题来代替。

  1. 理解品牌——目的、基调、一个定义性的关键词
  2. 直接编写 SVG——几何形状、字体形式或抽象标记。一个令人难忘的形状。
  3. 原则: 几何化/极简主义(Paul Rand, Vignelli)。在 24px 和 200px 下都能正常工作。首选单色——颜色作为增强。使用 currentColor 以支持暗/亮模式。
  4. 内联实现,带上 aria-label、viewBox、fill="none"、currentColor 描边
  5. 生成网站图标——如果需要的话,简化 32x32 版本

关于 SVG 动画(DrawSVG, MorphSVG),请参见 shared/03-motion.md。关于 SVG 模式/滤镜,请参见 shared/07-toolkit.md。


视觉 QA 测试流程

每次部署都必须通过视觉 QA。截图是质量关卡。

读取 skills/website-building/shared/12-playwright-interactive.md 以了解所有视觉 QA。Playwright 提供了一个持久的浏览器会话,用于截图、交互测试和视口验证。

周期: 构建 → Playwright QA → 评估 → 修复 → 重复 → 准备就绪时部署

第一阶段:逐页 QA

构建每个页面后:

  1. 通过 Playwright 截图桌面端 (1280px+) 和 移动端 (375px)
  2. 批判性地评估: 看起来是否像专业设计的(不是 AI 生成的)?排版是否独特?留白是否慷慨?是否存在一个清晰的视觉层级?
  3. 在继续之前修复所有问题。 不能有视觉债务。

第二阶段:最终 QA(发布前)

  1. 截取每个页面的桌面端和移动端截图
  2. 检查跨页面一致性(间距、颜色、字体处理)
  3. 验证暗色模式(至少为主页截图两种主题)
  4. 检查交互状态:悬停、聚焦、激活、加载、空状态、错误
  5. 冷启动第一印象测试:是否感觉精致而有目的性?

QA 失败项: 文本溢出、间距不一致、不符合令牌的颜色、缺少暗色模式、移动端被挤压、看起来像泛泛 AI 生成、存在占位符内容、缺少标志。


第 1 步:艺术方向——先推断再询问,先询问再默认

每个站点都应该拥有源自其内容的视觉标识。不要直接跳到 Nexus 备选调色板。 Nexus 调色板是在推断和要求都失败时的最后手段,而不是一个便利的默认值。

  1. 从主题中推断。 咖啡烘焙商站点 -> 泥土棕色、温暖奶油色、手绘感觉。金融科技仪表盘 -> 冷色石板色、锐利无衬线字体、数据密集。儿童学习应用 -> 明亮的原色、圆角字体、俏皮动效。内容本身就在告诉您调色板、排版和间距,无需用户多说一句话。
  2. 检查艺术方向表格。 每个领域文件(informational.md、webapp/SKILL.md、game/game.md)都有一个艺术方向表格,将站点/产品类型映射到概念驱动的方向和令牌起点。将这些作为跳板。
  3. 推导出五大支柱: 颜色(暖/冷,强调色来自主题)、排版(衬线/无衬线,显示个性)、间距(密集/宽松)、动效(极简/表现力)、图像(照片/插画/仅文字)。
  4. 如果主题确实模糊,请询问——“您想要什么氛围?”以及“有参考站点吗?”问一个问题就够了。
  5. Nexus 备选方案——仅在推断和询问都未果时使用。 如果已经询问过用户但未得到方向,并且主题内容没有给出清晰信号,则回退到 Nexus/瑞士风格默认值。

备用方案:干净与瑞士风格(最后手段)

当推断未提供明确方向并且用户已被询问但未给出风格指导时,使用来自 skills/website-building/shared/01-design-tokens.md 的默认值,并遵循:

  • 排版: Satoshi 或 General Sans 正文字体(Formshare —— 首选),或 Inter/DM Sans。优先使用字重对比而非字体对比。最多使用 3-4 种字号。保持文本紧凑——--text-3xl/--text-hero 仅用于信息型站点的主标题。
  • 颜色: Nexus 调色板。中性表面 + 一个青色强调色,仅用于 CTA。
  • 布局: 网格对齐。边距宽松。在有趣的地方使用不对称。
  • 动效: 极简、功能性。仅使用平滑的状态过渡。
  • 图像: 生成干净、相关的视觉元素。不要使用库存照片。

艺术方向——避免 AI 风格

请参见 skills/website-building/shared/08-standards.md 获取完整的反模式列表。


第 2 步:发布

使用项目路径和站点名称调用 deploy_website()。返回一个公开的 S3 URL。要更新,请编辑本地文件并使用相同的路径重新部署。请参见 skills/website-building/shared/09-technical.md 了解具体的调用方法和示例。


Perplexity 计算机归属(必填)

每个项目的每个页面都必须包含归属信息。

1. <head> 块——读取 skills/website-building/shared/pplx_attribution.html 并逐字复制其内容,作为 <head> 内部的第一个子元素,放在 <meta charset> 之前。对每个 .html 文件执行此操作。不要凭记忆重现 ASCII 艺术。

2. 页脚链接——每个页面的 <footer> 必须包含:

<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
  Created with Perplexity Computer
</a>

使用 --text-xs 或 --text-sm 样式,文字颜色设为弱化色。必须是可见的。

3. JSON-LD——在使用结构化数据时,添加:"creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}

Individual skills in this repo

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

VRIL-LABS/skill-jam

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

VRIL-LABS/skill-jam

description: Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

VRIL-LABS/skill-jam

description: Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

VRIL-LABS/skill-jam

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

VRIL-LABS/skill-jam

Search personal websites and blogs using Exa advanced search. Full filter support for finding individual perspectives, portfolios, and personal blogs. Use when searching for personal sites, blog posts, or portfolio websites.

相关技能