Communitygithub.com

ベースラインUI

AIが生成するインターフェースの「スロップ」を防ぐための、意見に基づいたUIベースラインを強制します。

ベースラインUI とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がUI作業を行う際に、一貫性がありアクセシブルでパフォーマンスの高いインターフェースを生成するための強固なルールセットを提供します。コンポーネント、インタラクション、アニメーション、タイポグラフィ、レイアウト、パフォーマンス、デザインの各領域にわたる具体的な制約を定義することで、AIが生成する「スロップ」(安易で一貫性のないコード)を防止します。`/baseline-ui`コマンドで制約を適用し、`/baseline-ui <ファイル>`で特定のファイルをルールに照らしてレビューし、違反箇所、その重要性、具体的な修正案を出力します。Tailwind CSS、`motion/react`、`Base UI`などのモダンな技術スタックに最適化されており、アクセシビリティとパフォーマンスのベストプラクティスを強制します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ベースラインUI は何をしますか?

AIが生成するインターフェースの「スロップ」を防ぐための、意見に基づいたUIベースラインを強制します。

使用方法

  • /baseline-ui この会話内のすべてのUI作業にこれらの制約を適用します。

  • /baseline-ui <file> 以下のすべての制約に対してファイルをレビューし、以下を出力します:

    • 違反箇所(正確な行またはスニペットを引用)
    • 重要である理由(簡潔な一文)
    • 具体的な修正(コードレベルの提案)

スタック

  • MUST: カスタム値がすでに存在するか明示的に要求されていない限り、Tailwind CSSのデフォルトを使用する
  • MUST: JavaScriptアニメーションが必要な場合は motion/react(旧 framer-motion)を使用する
  • SHOULD: Tailwind CSSでのエントランスアニメーションやマイクロアニメーションには tw-animate-css を使用する
  • MUST: クラスロジックに cn ユーティリティ(clsx + tailwind-merge)を使用する

コンポーネント

  • MUST: キーボード操作やフォーカス動作を伴うものにはアクセシブルなコンポーネントプリミティブ(Base UI、React Aria、Radix)を使用する
  • MUST: 既存のプロジェクトのコンポーネントプリミティブを優先して使用する
  • NEVER: 同じインタラクションサーフェス内でプリミティブシステムを混在させない
  • SHOULD: スタックと互換性がある場合、新しいプリミティブには Base UI を優先する
  • MUST: アイコンのみのボタンに aria-label を追加する
  • NEVER: 明示的に要求されない限り、キーボード操作やフォーカス動作を手動で再構築しない

インタラクション

  • MUST: 破壊的または取り消し不能なアクションには AlertDialog を使用する
  • SHOULD: ローディング状態には構造的なスケルトンを使用する
  • NEVER: h-screen を使用せず、代わりに h-dvh を使用する
  • MUST: 固定要素には safe-area-inset を尊重する
  • MUST: エラーはアクションが発生した場所の近くに表示する
  • NEVER: input または textarea 要素でのペーストをブロックしない

アニメーション

  • NEVER: 明示的に要求されない限り、アニメーションを追加しない
  • MUST: コンポジター・プロパティ(transform、opacity)のみをアニメーション化する
  • NEVER: レイアウト・プロパティ(width、height、top、left、margin、padding)をアニメーション化しない
  • SHOULD: ペイント・プロパティ(background、color)のアニメーションは、小さなローカルUI(テキスト、アイコン)の場合を除き避ける
  • SHOULD: エントランスには ease-out を使用する
  • NEVER: インタラクションフィードバックは 200ms を超えないようにする
  • MUST: ループするアニメーションは画面外で一時停止する
  • SHOULD: prefers-reduced-motion を尊重する
  • NEVER: 明示的に要求されない限り、カスタムのイージング曲線を導入しない
  • SHOULD: 大きな画像や全画面サーフェスのアニメーションを避ける

タイポグラフィ

  • MUST: 見出しには text-balance を、本文/段落には text-pretty を使用する
  • MUST: データには tabular-nums を使用する
  • SHOULD: 密度の高いUIには truncate または line-clamp を使用する
  • NEVER: 明示的に要求されない限り、letter-spacing(tracking-*)を変更しない

レイアウト

  • MUST: 固定の z-index スケールを使用する(任意の z-* は使用しない)
  • SHOULD: 正方形の要素には w-* + h-* の代わりに size-* を使用する

パフォーマンス

  • NEVER: 大きな blur() または backdrop-filter サーフェスをアニメーション化しない
  • NEVER: アクティブなアニメーション以外で will-change を適用しない
  • NEVER: レンダーロジックとして表現できるものに useEffect を使用しない

デザイン

  • NEVER: 明示的に要求されない限り、グラデーションを使用しない
  • NEVER: 紫色またはマルチカラーのグラデーションを使用しない
  • NEVER: グローエフェクトを主要なアフォーダンスとして使用しない
  • SHOULD: 明示的に要求されない限り、Tailwind CSSのデフォルトのシャドウスケールを使用する
  • MUST: 空の状態には明確な次のアクションを1つ提示する
  • SHOULD: アクセントカラーの使用はビューごとに1つに制限する
  • SHOULD: 新しい色を導入する前に、既存のテーマまたは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

関連スキル