Communitygithub.com

ComeOnOliver/skillshub

UI/UX 設計智慧。50 種風格、21 組色盤、50 組字體配對、20 種圖表、9 種技術堆疊(React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind、shadcn/ui)。可執行:規劃、建置、建立、設計、實作、審查、修正、改善、最佳化、增強、重構、檢查 UI/UX 程式碼。支援專案類型:網站、登陸頁面、儀表板、管理後台、電子商務、SaaS、作品集、部落格、行動應用程式、.html、.tsx、.vue、.svelte。可設計元件:按鈕、模態框、導覽列、側邊欄、卡片、表格、表單、圖表。風格:玻璃擬態、黏土擬態、極簡主義、粗獷主義、新擬態、bento grid、深色模式、響應式設計、擬物化、扁平設計。主題:色盤、無障礙性、動畫、佈局、排版、字體配對、間距、懸停效果、陰影、漸層。整合:shadcn/ui MCP 以搜尋元件與範例。

skillshub 是什麼?

這個 AI agent 技能(Callable Skill)為 UI/UX 設計提供一個全面性的指南與搜尋資料庫,涵蓋 50 多種風格、97 組色盤、57 組字體配對、99 條 UX 指引以及 25 種圖表類型,橫跨 9 種技術堆疊(含 React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind CSS 和 shadcn/ui)。它能根據使用者需求(如 SaaS、電子商務、健康照護等)產生完整的設計系統,並提供優先級權重建議(從「關鍵」的無障礙性與觸控互動,到「低」優先級的圖表選擇)。此技能主要透過 CLI 工具 (`search.py`) 運作,支援 `--design-system`、`--persist` 與特定領域搜尋,適用於任何支援命令列執行的 AI agent(如 Claude Code、Codex、Cursor 等)。它還能輸出階層式的 Master/Page 設計規範,並內建一份詳細的出貨前檢查清單,確保產出專業、一致且無障礙的使用者介面。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/Harmeet10000/skills/ui-ux-pro-max

在你喜歡的 AI 中提問

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

說明文件

UI/UX Pro Max - 設計智慧

專為網頁與行動裝置應用程式打造的全面設計指南。內含 50 多種風格、97 組色彩調色盤、57 組字體配對、99 條 UX 指引及 25 種圖表類型,橫跨 9 種技術堆疊。提供具優先級排序建議的可搜尋資料庫。

何時套用

在下列情況時,請參考這些指引:

  • 設計新的 UI 元件或頁面時
  • 選擇色彩調色盤與字體排版時
  • 審查程式碼以找出 UX 問題時
  • 建立登陸頁面或儀表板時
  • 實作無障礙性需求時

規則類別與優先級

優先級類別影響領域
1無障礙性關鍵ux
2觸控與互動關鍵ux
3效能高ux
4佈局與響應式高ux
5字體排版與色彩中typography, color
6動畫中ux
7風格選擇中style, product
8圖表與資料低chart

快速參考

1. 無障礙性(關鍵)

  • color-contrast - 一般文字的最小對比度需達 4.5:1
  • focus-states - 可互動元素需有可見的焦點環
  • alt-text - 重要的圖片需提供描述性替代文字
  • aria-labels - 僅含圖示的按鈕需使用 aria-label
  • keyboard-nav - Tab 鍵順序應符合視覺順序
  • form-labels - 使用具 for 屬性的 label

2. 觸控與互動(關鍵)

  • touch-target-size - 觸控目標最小需為 44x44 像素
  • hover-vs-tap - 主要互動應使用點擊/輕觸
  • loading-buttons - 非同步操作期間應停用按鈕
  • error-feedback - 錯誤訊息應顯示於問題附近
  • cursor-pointer - 為可點擊元素加上 cursor-pointer

3. 效能(高)

  • image-optimization - 使用 WebP、srcset、延遲載入
  • reduced-motion - 檢查 prefers-reduced-motion
  • content-jumping - 為非同步內容預留空間

4. 佈局與響應式(高)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - 行動裝置上主體文字最小為 16px
  • horizontal-scroll - 確保內容不超出視窗寬度
  • z-index-management - 定義 z-index 層級(10, 20, 30, 50)

5. 字體排版與色彩(中)

  • line-height - 主體文字使用 1.5-1.75
  • line-length - 每行限制在 65-75 個字元
  • font-pairing - 標題與主體字體風格需相匹配

6. 動畫(中)

  • duration-timing - 微互動使用 150-300 毫秒
  • transform-performance - 使用 transform/opacity,避免使用 width/height
  • loading-states - 使用骨架螢幕或載入旋轉器

7. 風格選擇(中)

  • style-match - 風格應符合產品類型
  • consistency - 所有頁面應使用相同風格
  • no-emoji-icons - 使用 SVG 圖示,而非表情符號

8. 圖表與資料(低)

  • chart-type - 圖表類型應符合資料類型
  • color-guidance - 使用無障礙色彩調色盤
  • data-table - 提供表格作為圖表的無障礙替代方案

如何使用

使用下方 CLI 工具搜尋特定領域。


先決條件

檢查 Python 是否已安裝:

python3 --version || python --version

如果 Python 未安裝,請根據使用者的作業系統進行安裝:

macOS:

brew install python3

Ubuntu/Debian:

sudo apt update && sudo apt install python3

Windows:

winget install Python.Python.3.12

如何使用此技能

當使用者提出 UI/UX 相關工作(設計、建置、建立、實作、審查、修正、改善)時,請遵循以下工作流程:

第一步:分析使用者需求

從使用者請求中提取關鍵資訊:

  • 產品類型:SaaS、電子商務、作品集、儀表板、登陸頁面等
  • 風格關鍵字:極簡、活潑、專業、優雅、深色模式等
  • 產業:醫療保健、金融科技、遊戲、教育等
  • 堆疊:React、Vue、Next.js,或預設為 html-tailwind

第二步:產生設計系統(必做)

總是先執行 --design-system 以取得包含推論的全面建議:

python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]

此命令會:

  1. 並行搜尋 5 個領域(product, style, color, landing, typography)
  2. 套用來自 ui-reasoning.csv 的推論規則以選擇最佳配對
  3. 回傳完整的設計系統:樣式模式、風格、色彩、字體排版、效果
  4. 包含應避免的反模式

範例:

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

第二步 b:持久化設計系統(主檔 + 覆寫模式)

若要儲存設計系統以進行跨工作階段的階層式擷取,請加上 --persist:

python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"

這會建立:

  • design-system/MASTER.md — 包含所有設計規則的全球真相來源
  • design-system/pages/ — 用於存放頁面特定覆寫設定的資料夾

搭配頁面特定覆寫:

python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"

這也會建立:

  • design-system/pages/dashboard.md — 該頁面偏離主檔的設定

階層式擷取如何運作:

  1. 在建置特定頁面(例如「結帳」頁面)時,先檢查 design-system/pages/checkout.md
  2. 如果頁面檔案存在,其規則將覆寫主檔
  3. 如果不存在,則僅使用 design-system/MASTER.md

情境感知的擷取提示:

我正在建置 [頁面名稱] 頁面。請閱讀 design-system/MASTER.md。
同時檢查 design-system/pages/[page-name].md 是否存在。
如果頁面檔案存在,請優先使用其規則。
如果不存在,請僅使用主檔規則。
現在,產生程式碼...

第三步:補充詳細搜尋(視需要)

取得設計系統後,可使用領域搜尋來取得額外細節:

python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]

何時使用詳細搜尋:

需求領域範例
更多風格選項style--domain style "glassmorphism dark"
圖表建議chart--domain chart "real-time dashboard"
UX 最佳實踐ux--domain ux "animation accessibility"
替代字體typography--domain typography "elegant luxury"
登陸頁面結構landing--domain landing "hero social-proof"

第四步:堆疊指引(預設:html-tailwind)

取得實作特定的最佳實踐。如果使用者未指定堆疊,則預設為 html-tailwind。

python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind

可用堆疊:html-tailwind、react、nextjs、vue、svelte、swiftui、react-native、flutter、shadcn、jetpack-compose


搜尋參考

可用領域

領域用途範例關鍵字
product產品類型建議SaaS、電子商務、作品集、健康照護、美容、服務
styleUI 風格、色彩、效果玻璃擬態、極簡主義、深色模式、粗獷主義
typography字體配對、Google Fonts優雅、活潑、專業、現代
color依產品類型的色彩調色盤saas、電子商務、健康照護、美容、金融科技、服務
landing頁面結構、CTA 策略英雄區、英雄置中、推薦、定價、社交證明
chart圖表類型、函式庫建議趨勢、比較、時間軸、漏斗、圓餅圖
ux最佳實踐、反模式動畫、無障礙性、z-index、載入
reactReact/Next.js 效能瀑布流、bundle、Suspense、memo、重新渲染、快取
web網頁介面指引aria、焦點、鍵盤、語意、虛擬化
promptAI 提示、CSS 關鍵字(樣式名稱)

可用堆疊

堆疊重點
html-tailwindTailwind 工具類別、響應式、無障礙性(DEFAULT)
react狀態、hooks、效能、模式
nextjsSSR、路由、圖片、API 路由
vueComposition API、Pinia、Vue Router
svelteRunes、stores、SvelteKit
swiftui視圖、狀態、導覽、動畫
react-native元件、導覽、列表
flutter部件、狀態、佈局、主題化
shadcnshadcn/ui 元件、主題化、表單、模式
jetpack-compose可組合項、修飾符、狀態提升、重組

範例工作流程

使用者請求:「請為專業護膚服務建立一個登陸頁面」

第一步:分析需求

  • 產品類型:美容/SPA 服務
  • 風格關鍵字:優雅、專業、柔和
  • 產業:美容/健康
  • 堆疊:html-tailwind(預設)

第二步:產生設計系統(必做)

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

輸出: 包含樣式模式、風格、色彩、字體排版、效果和反模式的完整設計系統。

第三步:補充詳細搜尋(視需要)

# 取得動畫與無障礙性相關的 UX 指引
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux

# 如有需要,取得替代字體選項
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography

第四步:堆疊指引

python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind

然後: 綜合設計系統 + 詳細搜尋結果,並實作設計。


輸出格式

--design-system 旗標支援兩種輸出格式:

# ASCII 方框(預設) - 最適合終端機顯示
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system

# Markdown - 最適合文件
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

取得更好結果的技巧

  1. 關鍵字要具體 - 「健康照護 SaaS 儀表板」優於「應用程式」
  2. 多次搜尋 - 不同的關鍵字會揭示不同的見解
  3. 結合領域 - 風格 + 字體排版 + 色彩 = 完整的設計系統
  4. 務必檢查 UX - 搜尋「animation」、「z-index」、「accessibility」以發現常見問題
  5. 使用堆疊旗標 - 取得實作特定的最佳實踐
  6. 迭代 - 如果第一次搜尋結果不符合,請嘗試不同的關鍵字

專業 UI 的常見規則

以下是經常被忽略、會讓 UI 顯得不專業的問題:

圖示與視覺元素

規則應做不應做
不使用表情符號作為圖示使用 SVG 圖示(Heroicons、Lucide、Simple Icons)使用如 🎨 🚀 ⚙️ 的表情符號作為 UI 圖示
穩定的懸停狀態懸停時使用顏色/不透明度轉場使用會導致版面位移的縮放變形
正確的品牌標誌從 Simple Icons 研究官方 SVG猜測或使用錯誤的標誌路徑
一致的圖示尺寸使用固定的 viewBox(24x24)搭配 w-6 h-6隨機混合不同的圖示尺寸

互動與游標

規則應做不應做
游標指標在所有可點擊/可懸停的卡片上加上 cursor-pointer在互動元素上保留預設游標
懸停回饋提供視覺回饋(顏色、陰影、邊框)沒有元素可互動的指示
流暢的轉場使用 transition-colors duration-200瞬間狀態改變或過慢(>500ms)

淺色/深色模式對比

規則應做不應做
淺色模式的玻璃卡片使用 bg-white/80 或更高不透明度使用 bg-white/10(過於透明)
淺色模式文字對比使用 #0F172A(slate-900)作為文字顏色使用 #94A3B8(slate-400)作為內文顏色
淺色模式的淡化文字最少使用 #475569(slate-600)使用 gray-400 或更淺的顏色
邊框可見性淺色模式使用 border-gray-200使用 border-white/10(不可見)

佈局與間距

規則應做不應做
浮動導覽列加上 top-4 left-4 right-4 間距將導覽列卡在 top-0 left-0 right-0
內容內邊距考量固定導覽列的高度讓內容隱藏在固定元素後面
一致的最大寬度使用相同的 max-w-6xl 或 max-w-7xl混合不同的容器寬度

交付前檢查清單

在交付 UI 程式碼前,請確認以下項目:

視覺品質

  • 不使用表情符號作為圖示(改用 SVG)
  • 所有圖示來自一致的圖示集(Heroicons/Lucide)
  • 品牌標誌正確(已從 Simple Icons 驗證)
  • 懸停狀態不會導致版面位移
  • 直接使用主題顏色(例如 bg-primary),而非 var() 包裝

互動

  • 所有可點擊元素都有 cursor-pointer
  • 懸停狀態提供清晰的視覺回饋
  • 轉場效果流暢(150-300 毫秒)
  • 焦點狀態在鍵盤導航時可見

淺色/深色模式

  • 淺色模式文字有足夠對比度(最低 4.5:1)
  • 玻璃/透明元素在淺色模式下清晰可見
  • 邊框在兩種模式下都可見
  • 交付前測試兩種模式

佈局

  • 浮動元素與邊緣有適當間距
  • 沒有內容隱藏在固定導覽列後面
  • 在 375px、768px、1024px、1440px 尺寸下都能正常顯示
  • 行動裝置上無橫向捲軸

無障礙性

  • 所有圖片都有替代文字
  • 表單輸入都有標籤
  • 顏色不是唯一的資訊指示方式
  • 已遵循 prefers-reduced-motion

Individual skills in this repo

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

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.

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

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相關技能