Communitygithub.com

ulasalyesil/personal-website-v2

强制执行一套有观点的UI基线,防止AI生成的界面质量低下。

personal-website-v2 是什么?

该技能用于约束AI生成界面的质量,通过一套精心设计的UI基线来避免常见的“AI界面垃圾”。它支持在任何对话中通过 `/baseline-ui` 命令应用这些约束,也可以针对特定文件进行审查,指出违规代码并给出修复建议。技能覆盖了选择技术栈(如Tailwind CSS、motion/react)、组件使用、交互动效、排版、布局、性能和设计等多个方面,确保生成的界面具有一致性、可访问性和高质量。适用于Claude Code、Cursor等AI编程助手,帮助开发者获得更可靠、更符合现代Web标准的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 的新对话。

文档

基线UI

强制执行一套有观点的UI基线,防止AI生成的界面质量低下。

使用方法

  • /baseline-ui 在当前对话中,对所有UI工作应用这些约束。

  • /baseline-ui <文件> 根据以下所有约束审查该文件,并输出:

    • 违规内容(引用确切的行/代码片段)
    • 为什么重要(一句简短的话)
    • 具体修复方法(代码级建议)

技术栈

  • 必须使用 Tailwind CSS 默认值,除非已存在自定义值或被明确要求
  • 必须使用 motion/react(原 framer-motion)来实现 JavaScript 动画
  • 应该使用 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

相关技能