Communitygithub.com

Geruyang/agent-skills-library

在建構全新 UI 或重塑現有介面時,提供具備特色與意圖的視覺設計指導。協助決定美學方向、字體排版,並做出不流於模板預設的設計選擇。

agent-skills-library 是什麼?

這個技能旨在協助 AI 代理(如 Claude Code、Cursor、Codex)在執行前端設計任務時,產出具有獨特視覺識別且不流於俗套的設計。它提供從設計原則、規劃流程到實際程式碼撰寫的完整指引,強調設計應植根於主題內容,而非套用通用模板。技能支援所有具備前端程式碼生成能力的平台,並透過結構化的兩階段流程(先制定設計計畫,再與客戶簡報比對)來避免常見的 AI 生成設計特徵,例如暖奶油色背景搭配紅陶色強調色、統一的圓角卡片佈局等。此技能由一個名為「SKILL.md」的檔案驅動,該檔案詳細說明了視覺結構、字體排印的細微差異、以及如何透過自我批評來打磨設計品質,最終幫助代理產出與客戶特定需求高度匹配的專業前端設計。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Geruyang/agent-skills-library/tree/HEAD/original-skills/x-anthropics-frontend-design-64f18a5

在你喜歡的 AI 中提問

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

說明文件

前端設計

請以設計工作室的設計總監身分來處理此專案,該工作室以賦予每位客戶獨特、絕不會與他人混淆的視覺識別而聞名。這位客戶已經拒絕了那些感覺陳腔濫調或套用模板的提案,並且願意為獨特的觀點付費:針對此簡報,做出經過深思熟慮且帶有明確立場的選擇,涵蓋色板、字體排版和佈局,並在合理的情況下承擔美學風險。

讓設計扎根於主題內容

如果簡報中沒有指明產品或主題內容是什麼,請在設計之前自行釐清,並與客戶確認。你可以提出一個具體的主題、設計的目標受眾,以及設計的主要任務,作為提議。如果你記憶中有任何關於客戶偏好的資訊,或是他們正在建構內容的相關背景,請將其作為線索。主題的產業、內容、材料和慣用語,正是獨特視覺選擇的來源——為 8 至 11 歲女孩設計的玩具,其美學將與給金融分析師的儀表板截然不同。在整個設計過程中,都要使用簡報中的真實內容和主題。

設計原則

對於網頁設計,「英雄區」是檢視者首先會看到的內容。以主題世界中最具特色的事物開場,並採用最合適的形式:標題、圖片、動畫、即時展示、互動時刻或其他處理方式。你的選擇必須經過深思熟慮:一個大數字搭配一個小標籤、輔助統計資料和漸層強調色是預設的處理方式,因此只有在這確實是最佳選項時才使用它。

字體排版承載了頁面的個性。你不需要為顯示用/標題文字和內文使用不同的字體:使用一個或兩個字體家族,如果使用兩個,請確保它們有明顯的區別。

審慎選擇你的字體,不要使用你在任何其他專案中都會隨手拈來的預設家族,並按照《字體排印風格元素》的默認指導,設定一個明確的字體比例尺,包含有意的字重、字寬和字距。當字體被用作標題或視覺元素時,應將字體本身作為設計中一個活躍的部分,而不是內容的中性傳遞載具。

預設將行長控制在少於 80 個字元。襯線字體可以稍微長一點;為襯線字體的內文設定比無襯線字體稍大的行高。

避免以下預設的字體排版處理方式;它們是生成頁面最常見的跡象:

  • 在標題中僅強調一個單字或片語,例如將一個字設為斜體/粗體或不同的顏色。
  • 對標籤使用全大寫。
  • 在內容上方添加不必要的字體排版標籤。

視覺結構就是資訊。結構性裝置,如外框、邊框、編號、標題線、分隔線、標籤等,會對內容進行有用的資訊編碼,而非僅僅是裝飾。許多通用設計使用編號標記(01 / 02 / 03),但這只有在內容確實構成一個序列時才合適——例如一個逐步流程或時間軸。在添加編號標記之前,請檢查內容是否真的是序列。

謹慎且有目的地使用非使用者觸發的動畫,僅用於吸引注意力。一個經過精心編排的時刻——一個頁面載入序列或一個揭示效果——會比零散的效果更有效;每個區塊的淡入滑上效果和每張卡片的懸停過渡效果是通用的預設做法,看起來就像是 AI 生成的。回應使用者操作(開啟、展開、確認)的動畫是受歡迎的,因為它能顯示出什麼改變了。

仔細考慮文字內容。通常設計簡報可能不包含真實內容,需要由你來構想文案和佔位內容。文案本身可能讓設計感覺像是模板。請參閱下方關於寫作的部分以獲得更多指導。

流程:規劃、比對簡報、建構、評論

作為校準,當前 AI 生成的設計往往集中在某些特徵上:

  1. 暖奶油色背景(接近 #F4F1EA),搭配高對比度的襯線顯示字體和紅陶色或暖土色強調色(通常接近 #D97757——Anthropic 自家 Claude 互動的強調色,因此在客戶的簡報中是一個明顯的跡象);
  2. 接近黑色的背景,搭配單一明亮的螢光綠或朱紅色強調色;
  3. 寬幅報紙風格的佈局,帶有極細分隔線、零邊框半徑和密集的新聞報紙風格欄位;
  4. SaaS 卡片套件:內容被切割成相同的圓角卡片,無論層級如何都使用相同的邊框半徑,每張卡片下方都帶有同樣柔和的灰色陰影(rgba(0,0,0,.1)),並將漸層渲染作為裝飾;
  5. 無論主題為何都會出現的模板裝飾:每個標題上方都有一個全大寫字母追蹤的標題線標籤;使用中間點連接的元資料字串('A · B · C');以 'WORD — fragment' 形式構建的標籤,使用帶空格的長破折號;用於代替黑色的染色近黑色(#0B0B0B, #111);用於小數據標籤的等寬字體;附加在連結和按鈕文字後的 '→' 箭頭。

所有這些特徵對於某些簡報來說都是合理的,但它們是預設值而不是經過選擇的結果,而且它們無論主題為何都會出現。如果簡報明確指出了視覺方向,請嚴格遵循——簡報本身的措辭永遠優先,即使它要求的是上述風格之一。如果某個方向是開放的,請不要將這些自由花在上述任何一個預設選項上。就像聘請一位人類設計師一樣,通常需要在發揮所長與將每個專案視為實驗和學習的機會之間取得謹慎的平衡。

分兩個階段進行。首先,根據客戶的設計簡報,集思廣益,制定一個簡短的設計計畫:建立一個包含顏色、字體、佈局和原則的精簡 token 系統。

  • 顏色:將核心基礎色板描述為 4-6 個命名的十六進位值。
  • 字體:字體家族及其角色。
  • 佈局:一個佈局概念,使用一句話的描述性文字和 ASCII 線框圖來構思和比較。包含對齊指導;內容應該是左對齊、居中對齊還是兩端對齊?
  • 原則:說明此頁面獨特性的高層級指導方針。

然後在開始建構之前,將該計畫與簡報進行比對:如果計畫的任何部分看起來像是你會為任何類似頁面產生的通用預設值(透過類似的提示來看看你是否會得出類似的結果),而不是為此特定簡報做出的選擇——請修改該部分,並說明你更改了什麼以及為什麼。只有在確認了你的設計計畫相對獨特之後,才應開始按照修改後的計畫撰寫程式碼。

撰寫程式碼時,請注意 CSS 選擇器權重的結構。很容易產生互相抵消的 CSS 類別(尤其當使用像 .section 這種基於類型的選擇器和像 .cta 這種基於元素的選擇器時)。這在區塊之間的內距/外距上經常發生。

克制與自我評論

將你的大膽用在一處。讓一個元素成為令人難忘的重點,讓周圍的一切保持安靜和克制,並刪除任何不服務於簡報的裝飾。在不刻意張揚的情況下,建構出符合品質底線的設計:響應式向下相容至行動裝置、可見的鍵盤焦點、尊重減少動畫設定、視覺上可及、和諧的色板。在建構時批評自己的工作,如果你的環境支援,拍攝螢幕截圖來檢視——一張圖片勝過千言萬語。考慮香奈兒的建議:出門前,照照鏡子,取下一件飾品。人類創作者有記憶,並且總是嘗試做一些新的事情,所以如果你有空間快速記下你嘗試過的東西,它可以幫助你未來的設計迭代。

更多關於設計中的文案

文字出現在設計中只有一個原因:讓它更容易理解和使用。它們是設計內容,而不是裝飾。在撰寫文案時,要帶入與處理間距和顏色時相同的意圖性和簡潔性。在寫任何東西之前,先問問設計需要表達什麼,以及如何最好地表達以幫助使用者導航體驗。

從最終使用者的角度出發。用使用者能理解的簡單語言來命名事物,而不是根據系統的建構方式。使用者管理的是「通知」,而不是「Webhook 設定」。用平實的詞彙描述某事物的功能或用途,而不是推銷它。對新使用者來說,具體且易於理解永遠比顯得聰明更好。

預設使用主動語態。CTA 按鈕應準確說明按下時會發生什麼:「儲存變更」,而不是「提交」。一個動作在整個流程中應保持相同的名稱,因此標示為「發布」的按鈕,產生的提示訊息應是「已發布」。介面的詞彙就像是使用者在產品中導航的路標。連貫性和一致性是讓人們熟悉操作的方式。

將失敗和空白狀態視為提供指引的時刻,而非營造氣氛的時刻。用介面的語調(而非個人語氣)解釋出了什麼問題以及如何修復。錯誤訊息不道歉,並且對發生的事情從不模糊。空白的畫面是一個邀請行動的訊號。

保持對話式語氣:使用平實的動詞、首字大寫的句子、無填充詞,語氣需符合品牌和受眾。讓每個書寫元素都只完成一項任務。

Individual skills in this repo

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

Geruyang/agent-skills-library

Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling

Geruyang/agent-skills-library

Use for new frontend applications, dashboards, games, creative websites, hero sections, and visually driven UI from scratch, or when the user explicitly asks for a redesign/restyle/modernization. Builds from clean, airy, high-taste, readable image-generated concept design with section-specific references, faithful implementation, and browser testing.

Geruyang/agent-skills-library

Use when testing, debugging, or making targeted improvements to rendered frontend apps through the Build Web Apps or web dev plugin: local dev servers, UI regressions, interaction bugs, console errors, responsive layout, and visual QA. Check whether the Browser plugin is available and use it first when it is; otherwise use regular Playwright with the recorded reason.

Geruyang/agent-skills-library

Design UI surfaces for browser games. Use when the user asks for HUDs, menus, overlays, responsive layouts, or visual direction that must protect the playfield.

Geruyang/agent-skills-library

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

Geruyang/agent-skills-library

Guide for building, configuring, and deploying microfrontends on Vercel. Use this skill when the user mentions microfrontends, multi-zones, splitting an app across teams, independent deployments, cross-app routing, incremental migration, composing multiple frontends under one domain, microfrontends.json, @vercel/microfrontends, the microfrontends local proxy, or path-based routing between Vercel projects. Also use when the user asks about shared layouts across projects, navigation between microfrontends, fallback environments, asset prefixes, or feature flag controlled routing.

Geruyang/agent-skills-library

Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware/proxy, data fetching, rendering strategies, and deployment on Vercel.

Geruyang/agent-skills-library

Use when sizing Public Equity Investing positions, finding equity hedges, or building an integrated position-and-hedge risk plan from a listed-equity thesis. Do not use for thesis construction, standalone event underwriting, trade execution, personal investment advice, or credit-instrument risk.

Geruyang/agent-skills-library

Integrate data visualizations into React and Next.js applications. Use when the user needs chart components, UML-like or architecture diagram components, React integration patterns, Next.js client or server boundaries, hydration-safe rendering, lazy loading, framework-aware performance, scroll-driven visual stories, or export guidance.

Geruyang/agent-skills-library

shadcn/ui expert guidance — CLI, component installation, composition patterns, custom registries, theming, Tailwind CSS integration, and high-quality interface design. Use when initializing shadcn, adding components, composing product UI, building custom registries, configuring themes, or troubleshooting component issues.

Geruyang/agent-skills-library

v0 by Vercel expert guidance. Use when discussing AI code generation, generating UI components from prompts, v0 CLI usage, v0 SDK/API integration, or integrating v0 into development workflows with GitHub and Vercel deployment.

Geruyang/agent-skills-library

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".

相關技能