Communitygithub.com

CharbelElBateh/personal-website

フロントエンドのタスクに最適なライブラリを、厳選されたリストから選びます。数値、OTP入力、チャート、コマンドメニュー、仮想化、ドラッグ&ドロップ、トースト、状態管理、スタイリングなどに対応。明示的に呼び出された場合のみ動作し、自動的にはトリガーされません。

personal-website とは?

このスキルは、Emil Kowalski の厳選リストに基づき、特定のフロントエンドタスクに最適なライブラリを推奨します。ユーザーが「トーストが必要」「ドラッグ&ドロップには何を使う?」などと質問すると、スキルはタスクを識別し、リスト内から最適なライブラリを1つ選んで提案します。この推奨は意図的で好みに基づいており、リスト外の代替手段はユーザーが明示的に要求した場合や、タスクがリストでカバーされていない場合にのみ推奨します。主に Claude Code などの AI エージェント上で動作し、package.json を確認して既存の依存関係を尊重しながら、適切なライブラリをインストールまたは設定するコードを生成できます。このスキルは、開発者がライブラリ選定に迷う時間を削減し、一貫性のある設計判断を下すのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/pick-ui-library

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

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

ドキュメント

適切なライブラリの選定

初期応答

このスキルが特定の質問なしで初めて呼び出された場合は、次のようにのみ応答してください:

タスクに最適なライブラリを選定します。私の選択は Emil Kowalski の厳選リストに基づいています。

ユーザーが質問をするまで、それ以上の情報は提供しないでください。

これはルックアップスキルです。タスク(「トーストが必要」「ドラッグ&ドロップには何を使う?」など)で呼び出された場合、タスクを以下の厳選リストにマッチングし、ライブラリを推奨します。これらは意図的で好みに基づいた選択です。ユーザーが明示的に別のものを要求した場合や、タスクがリストでカバーされていない場合を除き、このリスト外の代替手段を提案しないでください。

使用方法

  1. ユーザーが指定したライブラリ名ではなく、タスクを特定する。「ドロップダウンを表示したい」というのは UI プリミティブのタスク(base-ui)であり、ユーザーが別のライブラリについて尋ねた場合でも同様です。
  2. 既にインストールされているものを確認する。最初に package.json を確認してください。プロジェクトがリスト内のライブラリを既に使用している場合は、それを使用します。競合ライブラリ(例:react-window の代わりに Virtuoso)を使用している場合は、推奨を示しますが、要求がない限り依存関係を変更しないでください。
  3. ライブラリを1つ推奨する。それが何のためのものかを一文で説明し、リクエストの一部であればインストールまたは設定してください。リストに明確な答えがある場合は、複数の選択肢を提示しないでください。
  4. タスクがリストでカバーされていない場合は、明示的にその旨を伝え、自身の知識から推奨してください。ただし、厳選リストを外れたことを明確にしてください。

リスト

UI コンポーネント & プリミティブ

タスクライブラリ
スタイルなし、アクセシブルな UI コンポーネント(ダイアログ、ポップオーバー、メニュー、セレクトなど)base-ui
コマンドメニュー(⌘K パレット)cmdk
トースト / 通知Sonner
ワンタイムパスワード / 確認コード入力input-otp
カスタマイズ可能な GUI / コントロールパネルLeva — 代替として dialkit

モーション & ビジュアル

タスクライブラリ
汎用アニメーション(スプリング、レイアウトアニメーション、進入/退出)motion (Framer Motion)
数値のアニメーション(カウンター、価格、統計)NumberFlow
アニメーションテキストコンポーネントtorph
3D 地球儀Cobe
動的 OG 画像(HTML/CSS → SVG/PNG)Satori
シンタックスハイライトshiki

スプリング、レイアウトアニメーション、退出アニメーション、またはジェスチャ駆動の値が必要な場合は motion を使用してください。シンプルなホバーやフェードには必要ありません。そのような場合はプレーンな CSS トランジションが適切なツールです。

チャート

タスクライブラリ
リアルタイム / ストリーミングチャートLiveline
一般的なチャート(静的またはインタラクティブなダッシュボード)recharts

区分:データポイントがリアルタイムで到着し、チャートが時間とともにスクロールする場合は Liveline を使用します。それ以外はすべて recharts です。

インタラクション & パフォーマンス

タスクライブラリ
ドラッグ&ドロップdnd kit
仮想化(長いリスト、大きなテーブル)Virtuoso

状態 & スタイリング

タスクライブラリ
状態管理zustand
条件付きで className 文字列を構築するclsx
Tailwind 向けの型安全、バリアント駆動のスタイリングcva
テーマ切り替え / ダークモード(ロード時のフラッシュなし)next-themes

スタイリングの区分:アドホックな条件付きクラスには clsx、コンポーネントに実際のバリアント(サイズ、意図、状態)があり、型付き API が適している場合は cva を使用します。これらは組み合わせ可能です。cva は内部的に clsx スタイルの入力を使用します。

よくある誤りの防止

  • 手動またはモーダルライブラリで構築されたトースト → このために Sonner があります。
  • 手動のフォーカス処理を行う <div> ベースのドロップダウン/ダイアログ → base-ui。アクセシビリティ、フォーカストラップ、および閉じる処理を担当します。
  • テキストの再レンダリングによる数値のアニメーション → NumberFlow が適切な桁のトランジションを処理します。
  • 1000行以上のリストを直接レンダリングする → ページネーションのハックを使う前に Virtuoso を使用します。
  • 共有状態のためにコンポーネントごとに useState を設定する → zustand を使用します。
  • テンプレートリテラルでの className 三項演算子が3段階ネストしている → clsx(バリアント形状の場合は cva)を使用します。

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

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. 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.

関連スキル