Communitygithub.com

ComeOnOliver/skillshub

打造能產生共鳴、而不只是渲染的介面。此技能強制執行大膽且有目的的設計,並採用現代高效能技術棧。

skillshub 是什麼?

這是一個專為前端設計與開發人員設計的 AI 助手技能,旨在強制執行大膽且有目的的設計理念,確保每個像素的存在都有其正當理由。該技能支援 SvelteKit 5、Bun、Hono、shadcn-svelte 等現代高效能技術棧,並提供從設計意圖識別、資源載入到實作的完整工作流程。其核心座右銘是「不是建造更多,而是消除更多」,透過反平庸指令(Anti-Slop Mandate)來拒絕常見的、高機率的「安全」設計模式,例如 Bootstrap/Tailwind 預設值或常見字型配對。技能結構涵蓋產品類型分類、風格意圖、受眾分析,並能根據觸發關鍵字自動載入參考文件(如登陸頁面、排版、色彩系統、微動畫等),從而提供深入的實作模式。此外,它還強調無障礙性、印刷支援,以及交付前的全面檢查清單,確保視覺品質、互動性和主題一致性。對於希望突破設計同質化、追求獨特使用者體驗的開發者來說,這是一個不可或缺的工具。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aaaronmiller/frontend-design-masterclass/frontend-design-masterclass

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

前端設計大師班 v2.1

打造能產生共鳴、而不只是渲染的介面。此技能強制執行大膽且有目的的設計,並採用現代高效能技術棧。每個像素都必須證明其存在的理由。

1. 核心技術棧

  • 框架:SvelteKit 5 搭配 Runes($state、$derived、$effect)
  • 執行環境:Bun(伺服器、套件)
  • 後端 / API:Hono(邊緣優先路由、中介軟體)
  • UI 基礎元件:shadcn-svelte(無頭、可完全自訂)。覆蓋所有預設值。
  • 圖表:LayerChart(基於 Layer Cake,驅動 shadcn-svelte 圖表)
  • 動畫:Svelte Motion(@humanspeak/svelte-motion)用於複雜編排。 標準動畫使用內建的 svelte/transition 和 svelte/animate。簡單循環使用 CSS 關鍵影格(keyframes)。
  • Mermaid:beautiful-mermaid 用於主題化 SVG 渲染,並相容 Shiki
  • 樣式:Tailwind CSS v4,以 CSS 自訂屬性擴展
  • 測試:Playwright 用於視覺回歸測試
  • 素材:Nano Banana 用於生成式圖像與紋理
  • 部署:@sveltejs/adapter-static 用於靜態,@sveltejs/adapter-vercel 用於 SSR

2. 意圖識別(資源載入前)

在載入參考資料之前,先從三個維度對請求進行分類。這將影響後續的每個設計決策。

A. 產品類型

識別正在建構的內容。每個產品類型都隱含了風格、色彩和佈局的規範。

產品類別推薦風格色彩方向
SaaS / B2B / 生產力工具瑞士網格、扁平 + 玻璃態信賴藍 + 強調對比色
電子商務 / 零售鮮豔色塊、功能豐富展示品牌主色 + 成功綠
電子商務精品液態玻璃、電影感深色中性色 + 金色/香檳色強調色
金融科技 / 加密貨幣數據密集、深色模式 OLED深海軍藍/炭灰色 + 霓虹強調色
醫療保健 / 健康有機流動、柔和 UI柔和藍綠色/鼠尾草色 + 暖中性色
創意 / 作品集新粗獷主義、動態文字高對比 + 單一大膽強調色
遊戲 / 娛樂賽博龐克、HUD/科幻深色 + 霓虹多重強調色
教育 / 文件編輯式大版面、極簡暖紙色 + 墨水層次
AI / 機器學習平台極光 UI、動態驅動漸變主色 + 深色表面
儀表板 / 分析Bento 網格、數據密集中性表面 + 語義數據顏色

使用此表格作為起點指南針,而非限制。始終進行自訂。

B. 風格意圖

根據上下文線索、明確要求或產品類型來確定美學目標。 請參閱 references/landing-pages.md 第 3 節,了解 8 種永恆風格及其完整規格。

C. 受眾與情境

考慮使用者及其使用環境。企業受眾能接受高密度;消費受眾則需要呼吸空間。 行動優先會徹底改變觸控目標、字型比例和動畫強度。

3. 資源載入協定

在識別意圖後,掃描請求中的觸發關鍵字。從 references/ 載入對應的參考檔案, 以取得深入的實作模式。

登陸頁面與英雄區段

觸發詞:「登陸頁面」、「英雄區段」、「折頁上方」、「首頁」、「網站標題」、 「標題」、「CTA」、「行動呼籲」、「轉換」、「第一印象」 載入:references/landing-pages.md 提供:英雄區段解剖、8 種永恆登陸頁面風格(Apple Keynote、編輯式大版面、 幾何遊樂場、電影沉浸、瑞士網格、新粗獷主義、有機流動、復古終端)、 視覺流動模式(Z/F/黃金/對角線)、轉換架構、行動優先英雄策略、程式碼模式。

字型與字體選擇

觸發詞:「字型」、「字體」、「字體選用」、「標題」、「文字樣式」、 「字型配對」、「字級」、「字距」、「行高」、「易讀」、「展示字型」 載入:references/typography.md 提供:展示/內文/等寬字型目錄及配對建議、字級建構(數學比例)、 使用 clamp() 的響應式字體、可變字型、字型載入與效能、字型細節(追蹤、 懸掛標點、光學對齊)、易讀性檢查清單。

色彩系統與主題

觸發詞:「顏色」、「色板」、「主題」、「深色模式」、「淺色模式」、 「強調色」、「配色方案」、「品牌色」、「對比度」、「色相」、「飽和度」 載入:references/color-system.md 提供:結構化的 3 組色板架構(基調、主色調、強調色調)、色彩理論和諧模型、 色板生成工作流程、淺色主題建構、深色主題建構(獨立規則)、主題選擇器及 額外主題(暖色/冷色/單色/高對比變體)、語義色彩標記、CSS 自訂屬性系統、 WCAG 對比度合規。

圖像、紋理與背景

觸發詞:「圖片」、「背景」、「紋理」、「照片」、「插畫」、「抖色」、 「疊加」、「視差背景」、「英雄圖片」、「Nano Banana」、「雙色調」、「圖案」 載入:references/imagery.md 提供:圖片角色分類、尺寸與格式策略、三層背景構成、抖色演算法 (Atkinson/Floyd-Steinberg/Bayer)、疊加與幾何邊框(對角線、clip-path 形狀、 角落標記、網格疊加)、圖像中的動態、藝術風格選擇(寫實/插畫/生成式/ 混合媒體/雙色調)、按鈕和橫幅圖像、Nano Banana 整合、AI 圖片提示指南。

數據圖形、表格、圖表與資訊圖表

觸發詞:「表格」、「圖表」、「資訊圖表」、「數據」、「統計」、 「指標」、「儀表板 KPI」、「比較」、「時間線」、「流程圖」、「數字顯示」 載入:references/data-graphics.md 提供:超越預設的表格設計(無網格表格、狀態指示器、走勢圖儲存格、 固定標題、強調技巧)、圖表美學與敘事(漸層填充、發光效果、註釋、 網格替代方案)、Mermaid 圖表整合、資訊圖表模式(數字區塊、時間線、 比較網格、流程圖)、AI 數據視覺提示、印刷就緒數據圖形。

微動畫與互動控制項

觸發詞:「動畫」、「懸停」、「點擊」、「按鈕」、「切換」、「回饋」、 「漣漪效果」、「載入」、「骨架螢幕」、「過渡」、「貼齊」、「磁吸」、 「滾動動畫」、「微互動」、「響應式控制」、「狀態轉換」、「表單動畫」 載入:references/microanimations.md 提供:完整的 5 狀態按鈕系統(預設/懸停/啟用/焦點/禁用)、導覽回饋 (選單項目、漢堡選單、分頁指示器)、滾動驅動動畫(交錯顯示、進度條、 計數器動畫)、表單互動(浮動標籤、驗證回饋、自訂核取方塊)、載入狀態 (骨架螢幕、成功/錯誤)、頁面過渡、觸感模式(按壓、彈跳、卡片抬起、 漣漪效果)、貼齊與磁吸行為、效能規則、緩動與時序參考表。

視覺動態與深度

觸發詞:「3d」、「深度」、「視差」、「傾斜」、「假 3d」、「空間」、 「動態」、「動畫」、「玻璃態」、「全像」 載入:references/visual-kinetics.md 提供:動畫層級系統(CSS -> Svelte -> Svelte Motion -> GSAP)、 全像傾斜卡片(含眩光效果)、使用 Nano Banana 圖層的視差英雄區段、 玻璃態 2.0、動態文字(揭示遮罩、跑馬燈、分割文字)、滾動觸發顯示、 基於物理的緩動、磁吸按鈕、效能檢查清單。

數據視覺化(圖表與儀表板)

觸發詞:「layerchart」、「圖表元件」、「儀表板佈局」、「bento 網格」、 「走勢圖」、「即時」、「霓虹圖表」、「編輯式圖表」 載入:references/data-visualization.md 提供:LayerChart 可組合模式、shadcn-svelte 圖表整合、圖表美學模式 (霓虹/編輯式/極簡)、表格樣式配方、Bento 網格儀表板佈局、走勢圖、 即時數據模式、備用函式庫。

圖表(Mermaid)

觸發詞:「mermaid」、「圖表」、「流程圖」、「序列圖」、「架構圖」 載入:references/mermaid-theming.md 提供:beautiful-mermaid 設定與主題化、Shiki 整合、原生 Mermaid themeVariables 對應、SVG 後處理(紋理疊加、陰影、邊框)、 SvelteKit 元件模式、圖表類型樣式說明、印刷考量。

當偵測到多個觸發詞時,載入所有相關參考資料。 當未偵測到觸發詞時,直接套用下方的通用強制指令。

4. 反平庸指令

LLM 傾向於從訓練數據中收斂到高機率的「安全」設計模式。 這是分佈收斂。必須刻意對抗它。

拒絕:未經修改的 Bootstrap/Tailwind 預設值、Inter/Roboto/Arial/系統字型、 紫色配白色配色方案、可預測的卡片網格、千篇一律的英雄區段、 一切置中佈局、庫存照片、通用漸層、UI 中的表情符號圖示、魔法數字間距、 不可見的懸停狀態、導致佈局位移的縮放變換(hover 時)、 透明度低於 30% 的淺色模式玻璃卡片、低於 gray-500 對比度的弱化文字。

擁抱:有意的字型層級、不對稱構圖、氛圍深度、動態回饋、 編輯式網格、幾何視線引導、印刷級精準度、基於色彩理論的自訂色板、 獨特的字型配對、SVG 圖示系統(Lucide、Heroicons)搭配一致的 viewBox、 每個可點擊元素都有 cursor-pointer、使用顏色/透明度實現穩定的懸停狀態 (不進行破壞佈局的變換)。

5. 設計思考(編碼前)

在編寫程式碼之前,先確定方向:

  1. 目的:這解決了什麼問題?誰在使用它?
  2. 產品類型:使用第 2A 節的表格進行分類,以獲得初始方向。
  3. 美學基調:選擇一個並徹底執行。請參閱 references/landing-pages.md 第 3 節,了解 8 種經過驗證的風格。或者發明一種混合風格。
  4. 色彩方向:選擇主要色相,透過色彩理論和諧衍生強調色。 完整工作流程請參閱 references/color-system.md 第 3 節。
  5. 字型:從 references/typography.md 目錄中選擇展示 + 內文 + 等寬字型三件組。
  6. 令人難忘的細節:確定使用者會記住的一個元素。
  7. 複雜度匹配:極繁主義 = 精細的程式碼。極簡主義 = 外科手術般的精準。

6. 通用美學強制指令

字型

選擇獨特且富有個性的配對。從 Google Fonts 或 Fontsource 載入。 完整的字型目錄和配對策略請參閱 references/typography.md。 除非經過大幅修改,否則永不使用 Inter、Roboto、Open Sans、Lato 或預設系統字型。 永不在多個項目中收斂於 Space Grotesk。

顏色(結構化色板)

建立一個 3 組色板:基調、主色調、強調色調。 完整的系統請參閱 references/color-system.md。 淺色主題:硬陰影、粗體字型、細線條。 深色主題:彩色發光、米白色文字(#E8E8E8)、微妙的表面漸層。 永不使用純紫色(H: 270-280)作為主色。轉向靛藍、藍綠色、珊瑚色或祖母綠。

圖像與紋理

永不在英雄區段使用純色、單色背景。 三層構圖技術、抖色演算法和 Nano Banana 整合模式請參閱 references/imagery.md。

微動畫(強制)

每個互動元素都必須提供動態回饋。 完整的 5 狀態按鈕系統、滾動驅動動畫和觸感模式請參閱 references/microanimations.md。

空間構成

垂直支架、不對稱、負空間、突破網格的元素。 視覺流動模式請參閱 references/landing-pages.md 第 4 節。

無障礙性(不可妥協)

  • 語意化 HTML:<article>、<section>、<nav>、<aside>、<main>
  • 焦點狀態:永不使用 outline: none。樣式化為 outline: 2px solid var(--accent); outline-offset: 4px
  • WCAG AA 對比度最低要求。請參閱 references/color-system.md 第 9 節。
  • 在所有自訂互動元件上使用 ARIA 標籤
  • prefers-reduced-motion:禁用視差、傾斜、複雜動畫
  • 顏色絕不能作為狀態的唯一指示
  • 所有圖片都需要替代文字;表單輸入需要標籤

列印與 PDF

當 @media print 啟用時,網站必須能兼作可列印報告。 隱藏導覽/頁腳/按鈕,強制使用白色背景,保留 SVG 圖表, 在卡片/圖表/表格上使用 break-inside: avoid。

7. 實作工作流程

  1. 識別:對產品類型、風格意圖、受眾進行分類(第 2 節)。
  2. 載入:掃描資源觸發詞。載入相關參考檔案(第 3 節)。
  3. 研究:對於複雜的建構,進行深入研究(最多 10 次網路搜尋) 尋找可比較的獲獎網站、模式和函式庫功能。
  4. 架構:規劃 SvelteKit 檔案結構。定義 CSS 變數標記。
  5. 編碼:編寫語意化 HTML、擴展的 Tailwind、Svelte 5 Runes。 達到生產就緒,無佔位符。
  6. 打磨:應用微動畫、紋理圖層、懸停狀態、滾動觸發。
  7. 驗證:執行交付前檢查清單(第 8 節)。修復所有失敗項目。
  8. 迭代:與美學願景進行比較。調整直到脫穎而出。

8. 交付前檢查清單

在交付任何 UI 程式碼之前執行此檢查。每個項目都是一個已知的失敗模式。

視覺品質

  • 未使用表情符號作為 UI 圖示(使用 Lucide 或 Heroicons SVGs)
  • 所有圖示來自單一一致集,並搭配匹配的 viewBox(24x24)
  • 品牌標誌已根據官方來源驗證(Simple Icons)
  • 懸停狀態不會導致佈局位移(使用透明度/顏色,而非縮放變換)
  • 沒有未經自訂的預設 Tailwind 顏色類別
  • 字型配對是有意的且已載入(非系統備用)

互動

  • 每個可點擊元素都有 cursor-pointer
  • 每個互動元素都有可見的懸停回饋
  • 過渡使用 150-300ms 持續時間(UI 絕不超過 500ms,絕不為 0ms)
  • 焦點狀態可見且已設定樣式(非瀏覽器預設,也從未被移除)
  • 行動裝置上的觸控目標最小為 44x44px

淺色 / 深色模式

  • 淺色模式:文字對比度通過 WCAG 標準

…

[已截斷以利翻譯]

Individual skills in this repo

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

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

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.

ComeOnOliver/skillshub

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.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Next.js 16+ uses App Router with Server Components by default. Client Components are only used when interactivity is needed (hooks, event handlers, browser APIs).

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

相關技能