Communitygithub.com

ComeOnOliver/skillshub

用於建立 UI 設計時,避免落入通用的「AI 產物」美學。強制使用獨特的排版、一致的色彩系統、有目的性的動畫以及具氛圍的背景。對於登陸頁面、儀表板和品牌化介面至關重要。

skillshub 是什麼?

這個 AI 代理技能旨在解決 Claude 等 AI 工具在生成使用者介面時,因訓練資料偏向安全、通用的選擇,而導致的設計同質化問題(即「AI 產物美學」)。它提供了一套具體的設計原則與程式碼範例,幫助開發者建立真正具有品牌特色與高品質的前端 UI。技能的核心原則包括:使用真正的深色主題而非灰色、採用單一強調色並一致應用、打造既專業又可操作的數據密集型介面,並透過多層次背景與光暈效果創造微妙的深度感。此技能支援在 Claude Code、Cursor 或任何 AI 程式碼產生工具中使用,特別適用於登陸頁面、行銷網站、儀表板和管理後台。其運作方式透過明確的「應做」與「不應做」指南,涵蓋排版、色彩系統、動畫與背景四個設計維度,並提供 React (TypeScript) 與 Tailwind CSS 的程式碼範例,以及最終的視覺檢驗清單。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/barnhardt-enterprises-inc/frontend-aesthetics

在你喜歡的 AI 中提問

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

說明文件

前端美學技能

使用時機

在以下情況,請務必使用此技能:

  • 建立登陸頁面或行銷網站
  • 設計儀表板或管理介面
  • 建構品牌化 UI 元件
  • 審查設計的獨特性
  • 實作視覺潤飾與動畫

請勿在以下情況使用:

  • 處理後端/API 程式碼
  • 撰寫測試
  • 不會上線的快速原型

問題:分佈聚合

Claude 預設會產生通用設計,因為安全、普遍可接受的選擇主導了訓練資料。這造成了「AI 產物美學」:

  • 到處都是 Inter/Roboto 字型
  • 紫色/藍色漸層
  • 最少動畫
  • 平坦、無生命力的背景
  • 均勻分佈的色彩調色盤

此技能提供特定的替代方案,以跳脫這些預設值。

核心原則

  • 真正的深色主題(不是灰色——真正的深色調)
  • 單一強調色 - 選擇一個並一致地使用
  • 專業、可操作的 UI - 資料密集,而非裝飾性
  • 微妙的深度感 - 分層背景,而非平面

四個設計維度

1. 排版

避免: 將 Inter、Roboto、Arial 作為主要字型(作為備用字型是可以的)

獨特的替代方案:

/* 標題:粗體、獨特 */
--font-heading: 'Plus Jakarta Sans', 'Bricolage Grotesque', sans-serif;

/* 內文:乾淨、易讀 */
--font-body: 'Inter Variable', system-ui;

/* 程式碼/資料:具有特色的等寬字型 */
--font-mono: 'JetBrains Mono', 'Fira Code', monospace;

/* 其他獨特選項 */
/* 現代/科技:Space Grotesk, Outfit, Manrope */
/* 高級感:Playfair Display, Cormorant */
/* 親切感:Nunito, Quicksand, Poppins */

粗細對比:

// 務必:極端粗細變化
<h1 className="text-4xl font-black">Dashboard</h1>  // 900
<p className="text-base font-light">Subtitle</p>    // 300

// 切忌:最小變化
<h1 className="text-2xl font-semibold">Dashboard</h1>  // 600
<p className="text-base font-medium">Subtitle</p>      // 500

尺寸層級:

// 務必:清晰的視覺層級
<h1 className="text-5xl">Main Heading</h1>   // 48px
<h2 className="text-2xl">Section</h2>        // 24px
<p className="text-sm">Body text</p>         // 14px

// 切忌:不明確的層級
<h1 className="text-xl">Main Heading</h1>    // 太小
<h2 className="text-lg">Section</h2>         // 太相似

2. 色彩系統

原則:

  • 真正的深色基底 - 使用接近黑色,而非灰色(避免使用 gray-900、slate-900)
  • 單一強調色 - 為主要操作選擇一個品牌色
  • 語意色彩 - 綠色=成功,琥珀色=警告,紅色=錯誤
  • 文字層級 - 主要(明亮)、次要(柔和)、停用(暗淡)

色彩應用:

// 務必:主導背景 + 單一強調色
<div className="bg-neutral-950">
  <Button className="bg-brand-500 hover:bg-brand-400">
    Primary Action
  </Button>
</div>

// 切忌:均勻分佈的色彩(彩虹湯)
<div className="bg-gray-900">
  <Button className="bg-blue-500">Action 1</Button>
  <Button className="bg-green-500">Action 2</Button>
  <Button className="bg-purple-500">Action 3</Button>
</div>

// 務必:為你的品牌定義 CSS 變數
:root {
  --bg-base: /* 你的真正深色 */;
  --bg-surface: /* 稍微淺一點 */;
  --accent: /* 你的品牌色 */;
  --accent-hover: /* 較淺的變體 */;
}

3. 動態與動畫

原則:

  • 使用 CSS 進行簡單過渡
  • 使用 Framer Motion 進行編排動畫
  • 專注於高影響力的時刻(頁面載入、狀態改變)
  • 為列表使用交錯顯示

純 CSS 模式:

// 務必:流暢、有意義的過渡
<Button className="transition-all duration-200 ease-out hover:scale-105 hover:shadow-lg hover:shadow-brand-500/20">
  Hover Me
</Button>

// 務必:交錯的列表顯示
<div className="animate-in fade-in slide-in-from-bottom-4 duration-500 delay-100">
  Item 1
</div>
<div className="animate-in fade-in slide-in-from-bottom-4 duration-500 delay-200">
  Item 2
</div>

Framer Motion 模式:

import { motion } from 'framer-motion'

// 務必:編排好的頁面載入
const container = {
  hidden: { opacity: 0 },
  show: {
    opacity: 1,
    transition: { staggerChildren: 0.1 }
  }
}

const item = {
  hidden: { opacity: 0, y: 20 },
  show: { opacity: 1, y: 0 }
}

<motion.div variants={container} initial="hidden" animate="show">
  {items.map(i => (
    <motion.div key={i} variants={item}>{i}</motion.div>
  ))}
</motion.div>

// 切忌:靜態、無生命力的頁面
<div>{items.map(i => <div key={i}>{i}</div>)}</div>

4. 背景與深度

避免: 純色、平坦的背景

模式:

// 務必:具有氣氛深度的分層漸層
<div className="relative bg-neutral-950">
  {/* 使用品牌色的漸層光暈 */}
  <div className="absolute top-0 right-0 w-96 h-96 bg-brand-500/10 rounded-full blur-3xl" />

  {/* 次要的微妙光暈 */}
  <div className="absolute bottom-0 left-0 w-64 h-64 bg-brand-500/5 rounded-full blur-2xl" />

  {/* 內容 */}
  <div className="relative z-10">
    {children}
  </div>
</div>

// 務必:微妙的網格圖案
<div className="bg-neutral-950 bg-[linear-gradient(to_right,rgb(255_255_255/5%)_1px,transparent_1px),linear-gradient(to_bottom,rgb(255_255_255/5%)_1px,transparent_1px)] bg-[size:64px_64px]">
  {children}
</div>

// 務必:帶有光暈的卡片立體感
<Card className="bg-neutral-900 border border-white/5 shadow-xl shadow-black/50 hover:shadow-brand-500/10 transition-shadow">
  {content}
</Card>

反模式(「產物」清單)

切勿執行以下操作:

反模式為什麼不好應該怎麼做
到處使用 Inter 字型通用、一眼就能認出是 AI 產物使用獨特字型(如 Plus Jakarta Sans)
bg-gray-900灰色,不是真正的深色使用 bg-neutral-950 或自訂的真正深色
紫色/藍色漸層過度使用的 AI 美學使用單一品牌強調色、純色
均等的色彩分佈沒有視覺層級主導色彩 + 一個強調色
沒有動畫無生命力、靜態加入有意義的微互動
到處都是 rounded-full幼稚、不專業混合使用 rounded-lg 與尖角
深色背景上的白色卡片對比太強烈使用微妙的立體感搭配柔和邊框
通用圖示沒有品牌識別使用具有一致筆畫粗細的 Lucide

元件樣式範例

儀表板卡片

// 專業儀表板風格(使用你的品牌色作為強調色)
<Card className="bg-neutral-900 border border-white/5 rounded-xl p-6 hover:border-brand-500/20 transition-colors">
  <CardHeader className="pb-2">
    <CardTitle className="text-lg font-semibold text-white flex items-center gap-2">
      <Activity className="w-5 h-5 text-brand-400" />
      System Status
    </CardTitle>
  </CardHeader>
  <CardContent>
    <div className="text-3xl font-bold text-white">98.7%</div>
    <p className="text-sm text-zinc-400">Uptime this month</p>
  </CardContent>
</Card>

按鈕層級

// 主要 - 品牌色、顯眼
<Button className="bg-brand-500 hover:bg-brand-400 text-white font-medium">
  Create Project
</Button>

// 次要 - 幽靈樣式加邊框
<Button variant="outline" className="border-white/10 hover:bg-white/5 text-zinc-300">
  Cancel
</Button>

// 破壞性 - 紅色、嚴重(語意色彩)
<Button variant="destructive" className="bg-red-500/10 hover:bg-red-500/20 text-red-400 border border-red-500/20">
  Delete
</Button>

資料表格

// 專業資料顯示
<Table className="bg-neutral-900 rounded-xl border border-white/5">
  <TableHeader>
    <TableRow className="border-white/5 hover:bg-white/5">
      <TableHead className="text-zinc-400 font-medium">Project</TableHead>
      <TableHead className="text-zinc-400 font-medium">Status</TableHead>
    </TableRow>
  </TableHeader>
  <TableBody>
    <TableRow className="border-white/5 hover:bg-white/5">
      <TableCell className="text-white font-medium">My Project</TableCell>
      <TableCell>
        <Badge className="bg-green-500/10 text-green-400 border-green-500/20">
          Active
        </Badge>
      </TableCell>
    </TableRow>
  </TableBody>
</Table>

驗證檢查清單

在完成任何 UI 工作之前,請驗證:

  • 排版:不是使用 Inter/Roboto 作為主要字型
  • 色彩:使用真正的深色,而非灰色(gray-900、slate-900)
  • 強調色:單一品牌色一致地用於操作
  • 動態:頁面至少有一個有意義的動畫
  • 深度:背景有漸層或圖案,而非平坦
  • 層級:清晰的視覺重量差異(文字、按鈕)
  • 一致性:所有元件遵循既定的設計系統

支援檔案

  • typography-guide.md - 完整的字型搭配參考
  • motion-patterns.md - Framer Motion 食譜與 CSS 動畫
  • anti-patterns.md - 應避免事項的擴充範例

設計代幣標準

此技能符合 DTCG 2025.10(設計代幣社群組織)格式:

  • 副檔名:.tokens.json
  • 屬性以 $ 為前綴($value、$type、$description)
  • 三層架構:核心 → 語意 → 元件

請參閱 W3C DTCG 規格

資源

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

相關技能