Communitygithub.com

VRIL-LABS/skill-jam

打造獨特、生產品質的網站與網頁應用程式。根據框架(Next.js、React Native、純 HTML)導向正確的指南。涵蓋設計代碼、字體排版、動態效果、佈局、無障礙性和部署。

skill-jam 是什麼?

這個技能提供了一套完整、權威的指南,用於建立具有獨特視覺識別、避免「AI 生成」感的專業級網站與網頁應用。它首先透過一個框架偵測路由器(支援 Next.js、React Native 等)來判斷專案類型,然後根據專案類型(資訊型網站、網頁應用 or 瀏覽器遊戲)載入領域特定指南。所有專案都強制使用共享的設計代碼與字體排版檔案,以確保視覺一致性,但同時也鼓勵設計師先從網站內容推斷設計方向,避免直接使用預設調色盤。技能涵蓋了從 SVG Logo 生成、Playwright 視覺 QA、到 S3 靜態部署的完整工作流程。它支援 Claude Code 等 AI 代理工具,並且要求每個頁面都必須包含 Perplexity Computer 的歸屬標記。

相容平台✓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。

此技能涵蓋網頁專案的所有面向。 當透過 load_skill("website-building") 載入時,所有檔案會被複製到 workspace/skills/website-building/。請根據您的專案類型,按需讀取子檔案。對於網頁應用程式,請載入子技能:load_skill("website-building/webapp")。

通用設計原則(色彩哲學、預設調色盤、字體選擇)透過 design-foundations 與其他技能共享。此技能的共享檔案則以網頁特定的實作(CSS 變數、響應式代碼、基礎樣式表)來延伸那些基礎。您無需單獨載入 design-foundations——共用資料夾中的網頁專用版本已足夠全面。

使用 read 時請加上完整路徑,例如 skills/website-building/shared/01-design-tokens.md


框架偵測路由器

在依專案類型進行路由之前,請先識別框架:

訊號框架動作
package.json 中有 "next" 相依,或 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)使用 skills/website-building/webapp/SKILL.md 配合標準 Tailwind 指南
無 package.json,僅有 .html 檔案純 HTML/CSS/JS繼續使用標準共享檔案

框架特定檔案提供:

  • 確切的設定指令與版本號
  • 框架特定的 Tailwind 整合(Next.js 用 v4,RN 用 NativeWind)
  • 該框架專屬的路由、資料擷取與元件模式
  • 框架專屬的部署指南

讀取框架檔案後,請回到此技能的專案類型路由(下方)以載入領域特定的設計指南(資訊型/網頁應用/遊戲)。


專案類型路由

步驟 1:識別專案類型並載入領域特定指南:

專案類型動作範例
資訊型網站read skills/website-building/informational/informational.md個人網站、作品集、編輯/部落格、小型企業、登陸頁面
網頁應用程式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 設計系統的預設值與普遍適用的字體排版規則。對於網頁應用程式和儀表板,請跳過下方標記 † 的檔案——這些實作細節已預先配置在 fullstack 範本中。

如果使用者只說「網站」或「site」而無詳細說明,請詢問其類型,或預設為資訊型。


子檔案參考

共享 (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、KPI、迷你走勢圖需要資料視覺化時
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/。

† 網頁應用程式和儀表板請跳過——實作細節已預先配置在 fullstack 範本中。Design-tokens 與 typography 不可跳過——它們為所有專案類型提供了權威的設計系統預設值與字體選擇指南。

領域特定 —— 僅載入一個

檔案載入時機
load_skill("website-building/webapp")SaaS、儀表板、管理後台、電子商務、品牌體驗(子技能,含 fullstack 範本)
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 Logo(見下方)——除非使用者特別要求 SVG 輸出,否則 SVG 僅用於 Logo。儲存用於指引方向的網頁參考圖片。
  • 透過 Playwright 截圖。 讀取 skills/website-building/shared/12-playwright-interactive.md 以在桌面(1280px+)和行動裝置(375px)下進行截圖。與參考圖片進行比較。這是強制性的,非選擇性。請參閱下方的視覺 QA。
  • 直接編寫生產品質的程式碼。 HTML、CSS、JS、SVG。使用 bash 進行建置工具和檔案處理。

SVG Logo 生成

每個專案都應有一個自訂的內聯 SVG Logo。切勿使用 styled text 標題來替代。

  1. 理解品牌——目的、調性、一個定義性的詞彙
  2. 直接編寫 SVG——幾何形狀、字母形式或抽象標記。一個令人難忘的形狀。
  3. 原則: 幾何/極簡(Paul Rand、Vignelli 風格)。在 24px 和 200px 下都能正常運作。先以單色為主——顏色作為增強。使用 currentColor 以支援深色/淺色模式。
  4. 內聯實作,帶有 aria-label、viewBox、fill="none"、currentColor 筆劃
  5. 生成 favicon——如有需要,簡化為 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 → 評估 → 修正 → 重複 → 準備就緒後部署

階段 1:逐頁 QA

建置每個頁面後:

  1. 透過 Playwright 在桌面 (1280px+) 和行動裝置 (375px) 下截圖
  2. 嚴格評估: 它看起來像專業設計(而非 AI 生成)嗎?字體排版有特色嗎?留白是否充足?有清晰的視覺層級嗎?
  3. 在繼續之前修正所有問題。 不留視覺債務。

階段 2:最終 QA(發布前)

  1. 在桌面和行動裝置下為每個頁面截圖
  2. 檢查跨頁面一致性(間距、顏色、字體處理)
  3. 驗證深色模式(至少為主頁截取兩種主題的畫面)
  4. 檢查互動狀態:懸浮、焦點、啟用、載入、空、錯誤
  5. 冷啟動第一印象測試:它感覺夠精緻且有明確意圖嗎?

QA 失敗項目: 文字溢出、不一致的間距、非代碼顏色、缺少深色模式、行動裝置畫面擠壓、千篇一律的 AI 外觀、佔位符內容、缺少 Logo。


步驟 1:藝術方向——先推斷再詢問,先詢問再使用預設

每個網站都應根據其內容衍生出視覺識別。不要直接跳到 Nexus 備用調色盤。 Nexus 調色盤是所有推斷和詢問都失敗時的最後手段,而非一個方便的預設值。

  1. 從主題推斷。 咖啡烘焙商網站 → 大地色系、暖色奶油、手繪感。金融科技儀表板 → 冷調石板色、銳利無襯線字體、資料密集。兒童學習應用 → 明亮原色、圓潤字體、俏皮動畫。在使用者開口之前,內容本身就會告訴你調色盤、字體和間距。
  2. 查閱藝術方向表格。 每個領域檔案(informational.md、webapp/SKILL.md、game/game.md)都有一個藝術方向表格,將網站/產品類型對應到概念驅動的方向和代碼起點。將這些作為跳板。
  3. 推導出五大支柱: 色彩(暖/冷,強調色來自主題)、字體排版(有襯線/無襯線,顯示個性)、間距(緊湊/寬敞)、動態(極簡/表現力)、圖像(照片/插圖/純文字)。
  4. 如果主題確實不明確,請詢問——「您想要什麼樣的氛圍?」以及「有任何參考網站嗎?」問一個問題就夠了。
  5. Nexus 備用方案——僅在推斷和詢問都無結果時使用。 如果使用者已經被問過但沒有提供方向,而且主題本身也沒有給出明確訊號,那麼就回退到 Nexus/Swiss 預設值。

備用方案:乾淨與瑞士風格(最後手段)

當推斷沒有明確方向,且使用者已被詢問但未提供任何樣式指南時,使用 skills/website-building/shared/01-design-tokens.md 中的預設值,並配合:

  • 字體排版: 正文字體使用 Satoshi 或 General Sans(來自 Fontshare——首選),或 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 Computer 歸屬(強制)

每個專案的每個頁面都必須包含歸屬標記。

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.

相關技能