Communitygithub.com

ulasalyesil/personal-website-v2

強制執行一套有觀點的 UI 基準,以防止 AI 生成的介面垃圾。

personal-website-v2 是什麼?

這個技能定義了一套嚴格且有觀點的使用者介面基準,專門用來約束 AI 程式碼生成工具(如 Claude Code、Cursor 等),避免其產出平庸、不一致或效能不佳的「AI 介面垃圾」。它涵蓋了從技術棧選擇(強制使用 Tailwind CSS 預設值、motion/react 動畫庫、cn 工具函數)、元件設計(強制使用無障礙元件原語、禁止混用原語系統)、到互動行為(使用 AlertDialog 處理破壞性操作、禁止攔截貼上)、動畫效能(僅對合成器屬性動畫、禁止超過 200 毫秒的互動回饋)、排版佈局(使用 text-balance、固定 z-index 層級)以及設計風格(禁止漸層、禁止紫色)等各個面向。它作為一個 `/baseline-ui` 命令運作,開發者可以在對話中調用它來約束後續的所有 UI 工作,或對特定檔案進行審查,並輸出違規項目、原因及具體的程式碼層級修復建議。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/baseline-ui

在你喜歡的 AI 中提問

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

說明文件

Baseline UI

強制執行一套有觀點的 UI 基準,以防止 AI 生成的介面垃圾。

使用方式

  • /baseline-ui 在此對話中對任何 UI 工作套用這些約束條件。

  • /baseline-ui <檔案> 根據下列所有約束條件審查該檔案,並輸出:

    • 違規項目(引用確切的行數或程式碼片段)
    • 為何重要(一句簡短的說明)
    • 具體的修復方式(程式碼層級的建議)

技術棧

  • 必須使用 Tailwind CSS 預設值,除非已有自訂值或明確要求使用
  • 當需要 JavaScript 動畫時,必須使用 motion/react(原名 framer-motion)
  • 應使用 tw-animate-css 為 Tailwind CSS 中的進場與微動畫提供支援
  • 類別邏輯必須使用 cn 工具函數(clsx + tailwind-merge)

元件

  • 任何涉及鍵盤或焦點行為的元件,必須使用無障礙元件原語(Base UI、React Aria、Radix)
  • 必須優先使用專案中既有的元件原語
  • 絕不在同一個互動表面混合使用不同的原語系統
  • 若與技術棧相容,應優先為新原語選擇 Base UI
  • 只有圖示的按鈕必須加上 aria-label 屬性
  • 除非明確要求,否則絕不自行重建鍵盤或焦點行為

互動

  • 破壞性或不可逆的操作必須使用 AlertDialog
  • 載入狀態應使用結構化的骨架螢幕
  • 絕不使用 h-screen,應使用 h-dvh
  • 固定定位元素必須遵循 safe-area-inset
  • 錯誤訊息必須顯示在觸發動作的位置旁邊
  • 絕不在 input 或 textarea 元素中攔截貼上功能

動畫

  • 除非明確要求,否則絕不加入動畫
  • 只能對合成器屬性(transform、opacity)進行動畫
  • 絕不對版面屬性(width、height、top、left、margin、padding)進行動畫
  • 應避免對繪製屬性(background、color)進行動畫,除非是小型、局部 UI(如文字、圖示)
  • 進入動畫應使用 ease-out
  • 互動回饋的動畫持續時間絕不超過 200ms
  • 當畫面離開螢幕時,必須暫停循環動畫
  • 應尊重 prefers-reduced-motion 設定
  • 除非明確要求,否則絕不使用自訂緩動曲線
  • 應避免對大型圖片或全螢幕表面進行動畫

排版

  • 標題必須使用 text-balance,內文或段落則使用 text-pretty
  • 數據必須使用 tabular-nums
  • 密集的 UI 應使用 truncate 或 line-clamp
  • 除非明確要求,否則絕不修改 letter-spacing(tracking-*)

版面

  • 必須使用固定的 z-index 層級(禁止使用任意的 z-* 值)
  • 正方形元素應使用 size-*,而非 w-* + h-*

效能

  • 絕不為大型 blur() 或 backdrop-filter 表面製作動畫
  • 除非動畫正在進行中,否則絕不套用 will-change
  • 絕不使用 useEffect 來處理任何可以表示為渲染邏輯的行為

設計

  • 除非明確要求,否則絕不使用漸層
  • 絕不使用紫色或多色漸層
  • 絕不使用發光效果作為主要提示方式
  • 除非明確要求,否則應使用 Tailwind CSS 預設的陰影層級
  • 空狀態必須提供一個明確的下一步操作
  • 每個檢視畫面應限制僅使用一個強調色
  • 在引入新顏色之前,應優先使用既有主題或 Tailwind CSS 的顏色代碼

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

相關技能