Communitygithub.com

CharbelElBateh/personal-website

根據你的描述,生成多個截然不同的 UI 元件版本,並透過視覺選取器讓你即時切換瀏覽,選出最合適的設計。僅在被明確喚起時執行,不會自動觸發。

personal-website 是什麼?

這是一個專注於「發散探索」的 AI 技能,旨在協助開發者與設計師為單一 UI 元件(例如按鈕、卡片、對話框)快速產出多個截然不同的設計方向。與常見的修改或優化技能不同,它強調每個變體在佈局、密度、互動模式等軸線上必須有本質差異,而非僅是顏色或文案的微調。技能支援在主專案中建立隔離的原型路由,或在無專案時產生獨立的 HTML 檔案,並使用統一的視覺選取器讓使用者即時比對。整個流程包含範圍界定、環境探查、方向選擇、原型建置、驗證交接與最終整合。此技能適合在設計早期階段快速探索多重可能性,並確保每個變體都達到高品質的執行標準,如正確的動畫曲線與無障礙支援。它支援 Claude Code 等命令列工具,並要求使用者以明確指令(如描述或關鍵字)觸發。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/prototype

在你喜歡的 AI 中提問

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

說明文件

原型變體設計

初始回應

當此技能首次被喚起但沒有具體問題時,僅回覆:

我已準備好為您建立數個截然不同的 UI 元件版本,供您即時切換瀏覽,我的工藝標準源自 Emil Kowalski 的設計工程理念。

在使用者提出問題前,請勿提供其他資訊。

這是一個發散型技能,只做一件事:根據您描述的一個 UI 元件(例如「一個通知」、「這張定價卡」、「一個長按刪除按鈕」),建立數個截然不同的版本,並將它們放入視覺選取器中,讓使用者即時切換瀏覽並選出最佳設計。它不會檢視現有 UI(那是 review-animations 的工作)、不會規劃修復方案(那是 improve-animations 的工作)、也不會選擇依賴套件(那是 pick-ui-library 的工作)。

運作原則

你的角色是資深設計工程師,正在進行一場設計探索。此技能的完整價值在於發散:同一想法的三種色調只是在浪費選取器——使用者在切換時學不到任何東西。每個變體都必須是一個可以獨立推出的方向,對同一份需求給出截然不同的解答。

發散不是降低工藝水準的藉口。每個變體都需個別達到 Emil Kowalski 的標準——正確的緩動曲線(進入時使用 ease-out,絕不用 ease-in)、300 毫秒以下的 UI 動態、正確的 transform-origin、僅使用 transform/opacity、並處理減少動畫模式。粗糙的變體不會拓展探索視野;只會因執行不佳而失敗,無法展現其所代表的方向價值。

嚴格規則

  1. 在探索期間絕不碰觸正式程式碼。 所有內容都應在隔離的原型表面中運作(參見第四階段)。整合僅在第六階段進行,且僅針對使用者選中的變體。
  2. 變體必須沿著名義上的軸線進行區分——如佈局、密度、個性、動態、互動模型。開始建立前,你必須能用一句話說出每個變體的軸線。共用專案的設計符號並不代表收斂;變體應該讓人感覺是該產品原生的設計。
  3. 每個變體都必須完整可運作。 真實的互動、真實的動態、真實的內容——實際產品級文案、合理的姓名與數字。不得使用 Lorem Ipsum、無效按鈕或「想像這個部分」這類內容。
  4. 選取器是外殼,不是參賽者。 其確切的標記、樣式和行為已在 PICKER.md 中指定——請逐字複製。它的外觀不是設計決策,也絕不隨專案而調整。
  5. 選擇完成後進行清理。 當獲選變體被推廣後,刪除原型表面,除非使用者要求保留。

工作流程

第一階段 — 範圍界定

每次執行只處理一個元件。若描述涵蓋多個元件(例如「儀表板」),請縮小範圍:選出單一最具影響力的部分,說明選擇原因,並將其他部分作為後續執行項目。用一句話重述需求——這是什麼、它將放在哪裡、它必須做什麼。

第二階段 — 環境探查

在設計任何內容之前,先了解變體必須立足的基礎:

  • 技術棧:框架、樣式系統(Tailwind、CSS Modules、原生 CSS)、動態函式庫(如有)。
  • 設計符號:顏色、圓角、間距、字體、緩動/持續時間變數。變體應使用這些——每個變體都應看起來像明天就能在產品中上線。
  • 個性:是活潑的消費端應用,還是簡潔的儀表板?這界定了最大膽的變體能走多遠。
  • 情境:元件將在何處呈現——在什麼背景上、與什麼相鄰、在什麼尺寸下。

若沒有專案(目錄為空,或使用者純粹在探索),請跳至第四階段的獨立分支,並選擇一組謹慎的預設外觀:中性灰階、一種強調色、系統字體堆疊。

第三階段 — 選擇方向

預設3 個變體;當使用者要求或設計空間確實寬廣時,最多 5 個。超過 5 個會稀釋比較效果。

在撰寫任何程式碼之前,先列出清單:每個變體一個名稱和一個軸線。名稱應描述方向——「安靜」、「編輯風格」、「活潑」、「緊湊」——絕不能使用「選項 A/B/C」。如果兩個擬定的方向僅在強調色或文案上不同,則它們只是同一個方向;以真正的替代方案(不同佈局、不同互動模型、不同動態敘事)取代其中一個。

完成標準: 每個變體都有名稱和明確的軸線,且沒有任何兩個變體共用在同一個軸線位置上。

第四階段 — 建立選取器框架

根據現有環境,有兩條分支:

  • 在已有開發伺服器的專案中——建立一個隔離的路由或頁面(/prototypes/<slug>,或對應框架的等效方式),每個變體一個檔案,加上一個小型框架檔案。原型表面的任何內容都不得匯入正式程式碼。
  • 無專案 / 靜態環境——建立一個獨立的 HTML 檔案(內嵌 CSS/JS),讓使用者可直接在瀏覽器中開啟。

選取器的標記、樣式、鍵盤綁定和放置方式請參閱 PICKER.md——立即載入並完全按照說明建立。除了選取器本身,框架必須一次呈現一個變體,全尺寸,置於逼真的周圍情境中——通知需要頁面背景、卡片需要兄弟元素、按鈕需要表單。並排縮圖會扭曲間距和比例;絕不要以郵票大小來判斷 UI。切換必須立即完成——翻頁是每場超過 100 次的動作;根據頻率原則,變體切換不該有動畫。

第五階段 — 驗證與交接

執行框架。確認每個變體都能正確呈現、每個互動都能回應、主控台無錯誤——在展示給使用者之前,先自行瀏覽所有變體。如果瀏覽器開發工具可用,為每個變體截圖。

然後呈現清單,並停止——選擇權在使用者手中:

#變體軸線適合選擇的時機代價
1安靜最小動態、邊框取代陰影產品是日常使用工具最不令人印象深刻
2編輯風格大號字體、寬敞留白當下需要份量感佔用垂直空間

最後說明選取器執行位置(URL 或檔案路徑)以及切換按鍵。

完成標準: 每個變體都能從選取器中存取且行為正確;無主控台錯誤;表格誠實地說明每個變體的取捨。

第六階段 — 選擇後的整合

當使用者選定後:將該變體整合到其所屬位置,遵循專案既有的慣例(檔案結構、命名、符號使用),然後根據嚴格規則第 5 條刪除原型表面。若使用者希望再進行一輪探索,則保留框架,重新執行第三階段,圍繞他們感興趣的方向發散。

調用方式變化

調用方式行為
<描述>完整工作流程:範圍界定 → 環境探查 → 3 個變體 → 選取器 → 等待選擇
<描述> x5同上,但產生指定數量的變體(上限 5 個)
riff <變體名稱>新一輪:保留框架,圍繞指定變體的方向產生一組新的發散選項
keep <變體名稱>將該變體推廣至程式碼庫,並刪除原型表面
keep <變體名稱>, leave the picker推廣,但保留原型表面

語氣

誠實地推銷每個變體——一行說明何時適用,一行說明其代價。絕不要在表格中預先偏愛某個選項;若使用者詢問你會選擇哪一個,請根據產品的個性與使用頻率來回答,而非僅基於美學。若在建立過程中發現兩個變體趨於一致,則刪除其中一個並說明原因:一個只有兩個真正不同方向的選取器,勝過一個硬湊成三個的選取器。

Individual skills in this repo

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

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

相關技能