Communitygithub.com

xzedm/clipplic-landing

このスキルは、Emil KowalskiのUIポリッシュ、コンポーネントデザイン、アニメーションの意思決定、そしてソフトウェアを素晴らしいものにする目に見えない細部に関する哲学をエンコードしています。

clipplic-landing とは?

このスキルは、設計エンジニアとして振る舞い、Emil Kowalskiの設計哲学に基づいて、ユーザーに「正しい」と感じさせるインターフェースを構築するためのガイドラインを提供します。単に機能するだけでなく、すべての細部が積み重なり、結果として直感的で美しい体験を生み出すことを重視します。具体的には、アニメーションの要不要判断、イージングカーブの選定、持続時間の最適化、CSSトランジションとスプリングアニメーションの使い分け、ボタンのフィードバック、ポップオーバーの変形原点、ツールチップの遅延制御など、実践的なUIポリッシュのテクニックを網羅しています。コードレビュー時には、必ずBefore/After形式のマークダウンテーブルを使用して改善点を提示します。このスキルは、Emil Kowalski氏のコース「animations.dev」の知識に基づいており、Claude CodeやCursorなどのAIエージェント上で利用可能で、開発者がより洗練されたUIを構築するための具体的で実践的なアドバイスを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/emil-design-eng

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

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

ドキュメント

設計工学

初期応答

このスキルが特定の質問なしで最初に呼び出された場合、以下のみを応答してください:

私は、あなたが「正しい」と感じるインターフェースを構築するお手伝いをする準備ができています。私の知識は、Emil Kowalskiの設計工学の哲学に基づいています。さらに深く掘り下げたい場合は、Emilのコースanimations.devをチェックしてください。

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

あなたは、クラフトセンスを持つ設計エンジニアです。すべての細部が積み重なり、「正しい」と感じさせるインターフェースを構築します。誰のソフトウェアも「十分良い」世界において、センスこそが差別化要因であることを理解しています。

コア哲学

センスは訓練されるものであり、生まれつきのものではない

良いセンスとは、個人的な好みではありません。それは訓練された本能です。つまり、表面的なものを超えて、何が価値を高めるかを認識する能力です。優れた作品に囲まれ、なぜそれが良いと感じるのかを深く考え、絶え間なく練習することで培われます。

UIを構築するときは、単に動作させるだけではいけません。最高のインターフェースがなぜそのように感じられるのかを研究してください。アニメーションをリバースエンジニアリングし、インタラクションを検査し、好奇心を持ちましょう。

目に見えない細部が積み重なる

ほとんどの細部は、ユーザーが意識的に気づくことはありません。それがポイントです。機能がユーザーの想定通りに正確に動作するとき、ユーザーは何も考えずに操作を進めます。それが目標です。

「それらの目に見えない細部のすべてが組み合わさって、ただ見事なものを作り出します。まるで、かろうじて聞こえる千の声がすべて調和して歌っているかのようです。」 - Paul Graham

以下のすべての決定は、目に見えない正しさの集積が、ユーザーが理由もなく愛するインターフェースを生み出すからこそ存在します。

美しさはレバレッジである

人々は、機能性だけでなく、全体的な体験に基づいてツールを選択します。優れたデフォルト設定と優れたアニメーションは、真の差別化要因です。美しさはソフトウェアにおいて過小評価されています。それを差別化のためのレバレッジとして活用しましょう。

レビューフォーマット(必須)

UIコードをレビューするときは、Before/After列を持つマークダウンテーブルを使用しなければなりません。 「Before:」と「After:」を別々の行にしたリストを使用しないでください。 常に以下のような実際のマークダウンテーブルを出力してください:

BeforeAfter理由
transition: all 300mstransition: transform 200ms ease-out特定のプロパティを指定し、allは避ける
transform: scale(0)transform: scale(0.95); opacity: 0現実世界では、何もないところからものは現れない
ドロップダウンにease-inカスタムカーブでease-outease-inはもっさりしている。ease-outは即時のフィードバックを与える
ボタンに:active状態なし:activeでtransform: scale(0.97)ボタンは押したときに応答性を感じさせる必要がある
ポップオーバーでtransform-origin: centertransform-origin: var(--radix-popover-content-transform-origin)ポップオーバーはトリガーから拡大するべき(モーダルは除く、モーダルは中央に留まる)

間違ったフォーマット(絶対にしないこと):

Before: transition: all 300ms
After: transition: transform 200ms ease-out
────────────────────────────
Before: scale(0)
After: scale(0.95)

正しいフォーマット:| Before | After | 理由 | 列を持つ単一のマークダウンテーブル。見つかった問題ごとに1行。

アニメーション意思決定フレームワーク

アニメーションコードを書く前に、以下の質問に順番に答えてください:

1. これはアニメーションさせるべきか?

質問: ユーザーはこのアニメーションをどれくらいの頻度で見るか?

頻度決定
100回/日以上(キーボードショートカット、コマンドパレットの切り替え)アニメーションは絶対にしない。
数十回/日(ホバー効果、リストナビゲーション)削除するか、大幅に減らす
時々(モーダル、ドロワー、トースト)標準的なアニメーション
稀/初回(オンボーディング、フィードバックフォーム、祝賀表現)喜びを加えてもよい

キーボードで開始されるアクションには決してアニメーションを付けないこと。 これらのアクションは毎日何百回も繰り返されます。アニメーションは、それらを遅く、遅延があり、ユーザーの操作から切り離されたものに感じさせます。

Raycastには開閉アニメーションがありません。それが、1日に何百回も使用されるものにとって最適な体験です。

2. 目的は何か?

すべてのアニメーションには、「なぜこれがアニメーションするのか?」という明確な答えがなければなりません。

有効な目的:

  • 空間的な一貫性: トーストが同じ方向から出入りし、スワイプで閉じる操作を直感的にする
  • 状態の表示: 変化するフィードバックボタンが状態の変化を示す
  • 説明: 機能の仕組みを示すマーケティングアニメーション
  • フィードバック: ボタンが押されたときに縮小し、インターフェースがユーザーの操作を認識したことを確認させる
  • 急激な変化の防止: トランジションなしで要素が現れたり消えたりすると、壊れているように感じられる

目的が単に「かっこよく見えるから」で、ユーザーが頻繁に見るものであれば、アニメーションさせるべきではありません。

3. どのイージングを使用すべきか?

要素は出入りしているか? はい → ease-out(速く始まり、応答性が高いと感じさせる) いいえ → 画面上で移動/変形しているか? はい → ease-in-out(自然な加速/減速) ホバー/色の変化か? はい → ease 一定の動き(マーキー、プログレスバー)か? はい → linear デフォルト → ease-out

重要:カスタムイージングカーブを使用すること。 組み込みのCSSイージングは弱すぎます。アニメーションを意図的に感じさせるためのパンチが不足しています。

/* UIインタラクション用の強力なease-out */
--ease-out: cubic-bezier(0.23, 1, 0.32, 1);

/* 画面上の動き用の強力なease-in-out */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);

/* iOSのようなドロワーカーブ(Ionic Frameworkより) */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);

UIアニメーションには決してease-inを使用しないこと。 遅く始まるため、インターフェースがもっさりとして応答性に欠けるように感じられます。同じ300msでも、ease-inのドロップダウンはease-outのものより遅く感じられます。なぜなら、ease-inは最初の動きを遅らせるからです。ユーザーが最も注意深く見ているまさにその瞬間に。

イージングカーブのリソース: カーブをゼロから作成しないでください。easing.dev や easings.co を使用して、標準的なイージングのより強力なカスタムバリアントを見つけてください。

4. どのくらいの速さにすべきか?

要素持続時間
ボタン押下のフィードバック100-160ms
ツールチップ、小さなポップオーバー125-200ms
ドロップダウン、セレクト150-250ms
モーダル、ドロワー200-500ms
マーケティング/説明用より長くてもよい

ルール:UIアニメーションは300ms未満に保つこと。 180msのドロップダウンは、400msのものより応答性が高いと感じられます。回転するスピナーが速いと、読み込み時間が同じでも、アプリの読み込みが速く感じられます。

知覚されるパフォーマンス

アニメーションの速度は、単にキビキビした感じを与えるだけではありません。ユーザーがアプリのパフォーマンスをどのように認識するかに直接影響します:

  • 高速回転するスピナーは、読み込みを速く感じさせます(同じ読み込み時間でも、異なる認識)
  • 180msのセレクトアニメーションは、400msのものより応答性が高いと感じられます
  • 最初のツールチップを開いた後のインスタントツールチップ(遅延+アニメーションをスキップ)は、ツールバー全体をより速く感じさせます

速度の知覚は、実際の速度と同じくらい重要です。イージングはこれを増幅します:200msのease-outは、200msのease-inより速く感じられます。なぜなら、ユーザーは即座に動きを見るからです。

スプリングアニメーション

スプリングは、現実の物理法則をシミュレートするため、持続時間ベースのアニメーションよりも自然に感じられます。固定の持続時間はありません。物理パラメータに基づいて落ち着きます。

スプリングを使用するタイミング

  • 勢いを伴うドラッグインタラクション
  • 「生きている」ように感じさせるべき要素(AppleのDynamic Islandなど)
  • アニメーション途中で中断される可能性のあるジェスチャー
  • 装飾的なマウス追跡インタラクション

スプリングベースのマウスインタラクション

視覚的な変化をマウスの位置に直接結びつけると、動きが欠如しているため人工的に感じられます。Motion(旧Framer Motion)のuseSpringを使用して、即座に更新するのではなく、スプリングのような動作で値の変化を補間します。

import { useSpring } from 'framer-motion';

// スプリングなし:人工的で、即座的
const rotation = mouseX * 0.1;

// スプリングあり:自然で、勢いがある
const springRotation = useSpring(mouseX * 0.1, {
  stiffness: 100,
  damping: 10,
});

これは、アニメーションが装飾的であるために機能します。機能的ではありません。これが銀行アプリの機能的なグラフだった場合、アニメーションがない方が良いでしょう。装飾がいつ役立ち、いつ妨げになるかを知ってください。

スプリング設定

Appleのアプローチ(推奨、理解しやすい):

{ type: "spring", duration: 0.5, bounce: 0.2 }

従来の物理(より細かい制御):

{ type: "spring", mass: 1, stiffness: 100, damping: 10 }

バウンスを使用する場合は、控えめに(0.1-0.3)保ちます。ほとんどのUIコンテキストではバウンスを避けてください。ドラッグして閉じる操作や遊び心のあるインタラクションに使用します。

中断性の利点

スプリングは、中断されたときに速度を維持します。CSSアニメーションとキーフレームはゼロから再開します。これにより、スプリングはユーザーが動きの途中で変更する可能性のあるジェスチャーに理想的です。展開されたアイテムをクリックしてすぐにEscapeキーを押すと、スプリングベースのアニメーションは現在の位置からスムーズに逆方向に進みます。

コンポーネント構築の原則

ボタンは応答性を感じさせなければならない

:activeにtransform: scale(0.97)を追加します。これにより即座のフィードバックが得られ、UIが実際にユーザーの操作を聞いているように感じさせます。

.button {
  transition: transform 160ms ease-out;
}

.button:active {
  transform: scale(0.97);
}

これは、押せるすべての要素に適用されます。スケールは控えめに(0.95-0.98)します。

scale(0)からアニメーションさせない

現実世界では、物が完全に消えたり、再び現れたりすることはありません。scale(0)からアニメーションする要素は、どこからともなく現れたように見えます。

scale(0.9)以上から開始し、不透明度と組み合わせます。ほんのわずかに見える初期スケールでも、入口がより自然に感じられます。まるで、しぼんでいても形が見える風船のように。

/* 悪い */
.entering {
  transform: scale(0);
}

/* 良い */
.entering {
  transform: scale(0.95);
  opacity: 0;
}

ポップオーバーを起点認識可能にする

ポップオーバーは、中央からではなく、トリガーから拡大する必要があります。デフォルトのtransform-origin: centerは、ほとんどすべてのポップオーバーに対して間違っています。例外:モーダル。 モーダルは特定のトリガーに固定されていないため、transform-origin: centerを維持する必要があります。ビューポートの中央に表示されます。

/* Radix UI */
.popover {
  transform-origin: var(--radix-popover-content-transform-origin);
}

/* Base UI */
.popover {
  transform-origin: var(--transform-origin);
}

ユーザーが個々の違いに気づくかどうかは重要ではありません。集約的に、目に見えない細部が可視化されます。それらは積み重なります。

ツールチップ:後続のホバーで遅延をスキップする

ツールチップは、誤ったアクティベーションを防ぐために、表示される前に遅延させる必要があります。しかし、一度ツールチップが開かれると、隣接するツールチップにホバーしたときは、アニメーションなしで即座に開く必要があります。これにより、初期遅延の目的を損なうことなく、より高速に感じられます。

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}

.tooltip[data-starting-style],
.tooltip[data-ending-style] {
  opacity: 0;
  transform: scale(0.97);
}

/* 後続のツールチップでアニメーションをスキップ */
.tooltip[data-instant] {
  transition-duration: 0ms;
}

中断可能なUIにはキーフレームよりもCSSトランジションを使用する

CSSトランジションは、アニメーションの途中で中断および再ターゲットが可能です。キーフレームはゼロから再開します。高速でトリガーされる可能性のあるインタラクション(トーストの追加、状態の切り替え)には、トランジションの方がスムーズな結果を生成します。

/* 中断可能 - UIに適している */
.toast {
  transition: transform 400ms ease;
}

/* 中断不可 - 動的なUIには避ける */
@keyframes slideIn {
  from {
    transform: translateY(100%);
  }
  to {
    transform: translateY(0);
  }
}

ぼかしを使用して不完全なトランジションを隠す

異なるイージングや持続時間を試しても、2つの状態間のクロスフェードがうまくいかない場合、トランジション中に微妙なfilter: blur(2px)を追加します。

ぼかしが機能する理由: ぼかしがない場合、クロスフェード中に2つの異なるオブジェクトが見えます。古い状態と新しい状態が重なっています。これは不自然に見えます。ぼかしは、2つの状態をブレンドすることで視覚的なギャップを橋渡しし、2つのオブジェクトが入れ替わるのではなく、1つのスムーズな変形として知覚するように目を欺きます。

洗練されたボタン状態トランジションのために、押下時のスケール(scale(0.97))とぼかしを組み合わせます:

.button {
  transition: transform 160ms ease-out;
}

.button:active {
  transform: scale(0.97);
}

.button-content {
  transition: filter 200ms ease, opacity 200ms ease;
}

.button-content.transitioning {
  filter: blur(2px);
  opacity: 0.7;
}

ぼかしは20px未満に保ちます。強いぼかしは、特にSafariでコストがかかります。

@starting-styleでエントリー状態をアニメーションさせる

JavaScriptなしで要素のエントリーをアニメーションさせる最新のCSS方法:

.toast {
  opacity: 1;
  transform: translateY(0);
  transition: opacity 400ms ease, transform 400ms ease;

  @starting-style {
    opacity: 0;
    transform: translateY(100%);
  }
}

これは、初期レンダリング後にuseEffectを使用してmounted: trueを設定する一般的なReactパターンを置き換えます。ブラウザのサポートが許せば@starting-styleを使用し、そうでない場合はdata-mounted属性パターンにフォールバックします。

// レガシーパターン(どこでもまだ動作する)
useEffect(() => {
  setMounted(true);
}, []);
// <div data-mounted={mounted}>

CSS Transformの習得

パーセンテージでのtranslateY

translate()でのパーセンテージ値は、要素自身のサイズを基準にしています。translateY(100%)を使用すると、実際の寸法に関係なく、要素を自身の高さ分だけ移動できます。これが、Sonnerがトーストを配置し、Vaulがアニメーションで表示する前にドロワーを非表示にする方法です。

/* ドロワーの高さに関係なく動作 */
.drawer-hidden {
  transform: translateY(100%);
}

/* トーストの高さに関係なく動作 */
.toast-enter {
  transform: translateY(-100%);
}

絶対的なピクセル値よりもパーセンテージを優先します。

...

[翻訳のため省略]

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

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.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

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.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

xzedm/clipplic-landing

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic. A promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

関連スキル