Communitygithub.com

モーションクラフト

GPUアクセラレーションアニメーションをWeb Animations API(WAAPI)、スクロール駆動アニメーション(ScrollTimeline/ViewTimeline)、FLIPテクニック、イージングシステム、アクセシビリティ(prefers-reduced-motion)を用いて設計します。ユーザーがWeb UI向けのアニメーション、トランジション、スクロール効果、ページ遷移、インタラクティブモーションの作成を依頼した場合に使用します。キャンバスベースのアニメーション(Three.js、PixiJS)、動画編集、非Web(ネイティブモバイル)のモーションデザインには使用しないでください。

モーションクラフト とは?

このスキルは、UIアニメーションを飾りではなくコミュニケーションの手段として捉え、すべてのフレームに存在理由を持たせることを目的としています。Emil Kowalski(Linear、Sonner、Vaul)、Paul Lewis(Google Chrome)、CSS Animation Working Groupから着想を得ており、Web Animations API(WAAPI)、Scroll-Driven Animations(ScrollTimeline/ViewTimeline)、FLIPテクニック、イージングシステム、そしてprefers-reduced-motionによるアクセシビリティ対応に焦点を当てています。対応プラットフォームはWebブラウザ(Chrome、Firefox、Safari、Edge)で、Framer MotionやThree.jsなどのライブラリに依存せず、標準Web技術を活用します。ワークフローは「アニメーションすべきか?」→「目的は何か?」→「イージングは何を使うか?」→「速度はどれくらいか?」という4段階の意思決定フレームワークに従い、特にキーボード操作による頻繁なアクションにはアニメーションを付けないこと、transformとopacityのみをアニメーションさせて60fpsを維持すること、非対称なenter/exitタイミング(enterは遅く、exitは速く)が重要です。また、レビュー時にはBefore | After | Why形式のテーブルを使用することが必須で、リスト形式は禁止されています。

対応~Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/EliasOulkadi/shokunin/tree/HEAD/.pack/skills/motion-craft

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

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

ドキュメント

モーションクラフト は何をしますか?

コミュニケーションのためのアニメーション、装飾のためではない。すべてのフレームはその存在を正当化しなければならない。

Emil Kowalski(Linear、Sonner、Vaul)、Paul Lewis(Google Chrome)、CSS Animation Working Groupから着想を得ています。

ワークフロー

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

アニメーションコードを記述する前に、これら4つの質問に順番に答えてください。

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

頻度判断理由
1日100回以上(キーボードショートカット、コマンドパレット、検索トグル)アニメーションなし。常に。アニメーションは頻繁な操作を遅く感じさせる。Raycastには開閉アニメーションがない。最適。
1日数十回(ホバー効果、リストナビゲーション)削除または大幅に削減繰り返しの操作では、ユーザーはアニメーションのレイテンシに気づく
時々(モーダル、ドロワー、トースト)標準アニメーションモーションに適した場面
稀/初回(オンボーディング、確認、祝福)喜びを加えるこれらの瞬間は、より長くリッチなアニメーションに値する

キーボードで開始される操作には絶対にアニメーションを付けないこと。 これらは毎日何百回も繰り返される。

2. 目的は何か?

すべてのアニメーションは「なぜアニメーションするのか?」に対する明確な答えを持たなければならない。

目的例妥当?
空間的一貫性トーストが同じ方向から出入りする?
状態表示ボタンが変形して「送信済み」を示す?
フィードバックボタンが押下時に縮小し、インターフェースがユーザーを認識したことを確認させる?
急激な変化の防止要素が突然現れるのではなく、フェードインする?
説明機能の仕組みを示すマーケティングアニメーション?
「見た目がかっこいい」かつユーザーが頻繁に見る不必要なモーション?

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

シナリオイージングCSS
要素の進入ease-out(速く始まり、レスポンシブに感じる)cubic-bezier(0, 0, 0.2, 1)
要素の退出ease-in(ゆっくり始まり、注意を一瞬引きつけてから加速して去る)cubic-bezier(0.4, 0, 1, 1)
画面上の移動/変形ease-in-outcubic-bezier(0.4, 0, 0.2, 1)
ホバー/色変更easecubic-bezier(0.25, 0.1, 0.25, 1)
一定の動き(マーキー、プログレスバー)linearcubic-bezier(0, 0, 1, 1)
UIインタラクション(ボタン、ツールチップ、ドロップダウン)強いease-outcubic-bezier(0.23, 1, 0.32, 1)

重要:UIの進入アニメーションにease-inを使用してはならない。 同じ300msでも、ease-inのドロップダウンはease-outのものより遅く感じられます。なぜなら、ease-inは最初の動き(ユーザーが最も注意深く見ている瞬間)を遅らせるからです。

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

要素持続時間イージング
ボタン押下フィードバック(スケール)100-160mscubic-bezier(0.23, 1, 0.32, 1)
ツールチップ進入/退出125-200mscubic-bezier(0.23, 1, 0.32, 1)
ドロップダウン/選択/ポップオーバー150-250mscubic-bezier(0.23, 1, 0.32, 1)
ホバー変形(スケール、浮き上がり)200mscubic-bezier(0.23, 1, 0.32, 1)
モーダル/ダイアログ進入200-300mscubic-bezier(0, 0, 0.2, 1)
モーダル/ダイアログ退出150-200mscubic-bezier(0.4, 0, 1, 1)
ドロワー/シート進入200-400mscubic-bezier(0.32, 0.72, 0, 1)(iOS風)
トースト進入300-400mscubic-bezier(0.23, 1, 0.32, 1)
トースト退出200-300mscubic-bezier(0.4, 0, 1, 1)
ページ遷移300-400mscubic-bezier(0.4, 0, 0.2, 1)
スクロールリビール(フェード+スライドアップ)400-800mscubic-bezier(0.16, 1, 0.3, 1)
ローディングシマー1000-1500ms(無限)linear
長押し削除(押下)2000mslinear(意図的)
長押し削除(解放)200mscubic-bezier(0.23, 1, 0.32, 1)(スナッピー)
マーケティング/説明用800-3000ms可変、ナラティブに依存

ルール:UIアニメーションは300ms未満に保つこと。 180msのドロップダウンは、400msのものより著しくレスポンシブに感じられます。

カスタムイージングカーブ

組み込みのCSSのease/ease-in/ease-outは弱すぎます。以下のより強いカスタムバリアントを使用してください:

:root {
  --ease-out-strong: cubic-bezier(0.23, 1, 0.32, 1);     /* UIインタラクション、Emilのシグネチャ */
  --ease-in-out-strong: cubic-bezier(0.77, 0, 0.175, 1);  /* 画面上の移動 */
  --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);          /* iOS風ドロワー */
  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);         /* ゆっくりとしたリビール、劇的 */
  --ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);       /* 代替の強いease-out */
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);       /* わずかなオーバーシュート、控えめに */
}

出典: easing.dev, easings.co


60fpsの黄金律

1フレームあたり16.67ms。Chrome DevToolsのPerformanceタブで確認すること。transformとopacityのみをアニメーションさせること。

プロパティGPU合成?トリガー
transform (translate, scale, rotate)? はい合成のみ
opacity? はい合成のみ
filter?? 場合による描画 + 合成
clip-path?? 場合による描画 + 合成
width, height, top, left, margin, padding, border-width? いいえレイアウト + 描画 + 合成
box-shadow? いいえ描画 + 合成
color, background-color? いいえ描画のみ

レビュー形式(必須)

UIアニメーションコードをレビューする際には、Before | After | Whyの列を持つマークダウンテーブルを使用しなければなりません。「Before:」と「After:」を別々の行にしたリストを使用してはなりません。

正しい形式:

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-out正確なプロパティを指定する; レイアウト再計算を引き起こす all を避ける
transform: scale(0)transform: scale(0.95); opacity: 0現実世界では何もないところから現れるものはない
ドロップダウンの ease-incubic-bezier(0.23, 1, 0.32, 1)ease-in はゆっくり始まる – 鈍く感じる。強いease-outは即時のフィードバックを与える
ボタンの :active 状態なし:active での transform: scale(0.97)ボタンは押下にレスポンシブでなければならない
ポップオーバーの transform-origin: centertransform-origin: var(--radix-popover-content-transform-origin)ポップオーバーはトリガーからスケールするべき。モーダルは中央に留まる。
prefers-reduced-motion なしの transition: 300ms@media (prefers-reduced-motion: reduce) { transition-duration: 0.01ms }WCAG 2.1 では動きの低減サポートが必要
Framer Motion での animate={{ x: 100 }}animate={{ transform: "translateX(100px)" }}Framer Motionの x/y はハードウェアアクセラレーションされない。GPUのために transform 文字列を使用する

間違った形式(絶対にしないこと):

Before: transition: all 300ms
After: transition: transform 200ms ease-out

CSSトランジション(UIに推奨)

CSSトランジションは中断可能です – アニメーションの途中でターゲットを変更できます。キーフレームはゼロから再開します。トースト、トグル、ドロップダウンなど、頻繁にトリガーされる可能性のあるインタラクションでは、トランジションの方がスムーズな結果をもたらします。

.button {
  transition: transform 160ms ease-out;
}
.button:active {
  transform: scale(0.97);
}

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

非対称なenter/exitタイミング

Enterは遅くしてもよい(ユーザーが決定している)、exitは速くなければならない(システムが応答している):

.overlay {
  transition: clip-path 200ms ease-out;  /* 解放: 高速 */
}
.button:active .overlay {
  transition: clip-path 2s linear;       /* 押下: 低速で意図的 */
}

ツールチップ: 連続ホバー時の遅延をスキップ

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}
.tooltip[data-instant] {
  transition-duration: 0ms;
}

@starting-style を使用した進入状態(2026年時点でChromeのみ、まだBaseline未対応)

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

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

注: @starting-style およびスクロール駆動アニメーション(animation-timeline: view()、animation-timeline: scroll())は、2026年時点でChromeのみです。クロスブラウザ対応にはJavaScriptのフォールバックを使用してください。

長押し削除パターン

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;   /* 解放: 高速 */
}
.button:active .overlay {
  clip-path: inset(0 0 0 0);
  transition: clip-path 2s linear;        /* 押下: 低速で意図的 */
}

ボタン - 触覚フィードバック

すべての押下可能な要素には物理的な反応が必要です。

.button {
  transition: transform 160ms cubic-bezier(0.23, 1, 0.32, 1);
}
.button:active {
  transform: scale(0.97);
}

スケールは微妙に(0.95-0.98)すること。ボタン、カード、リストアイテム、タブなど、すべての押下可能な要素に適用します。


ポップオーバー - 起点認識

ポップオーバーはトリガーからスケールし、中央からではありません。モーダルは中央に留まります。

/* Radix UI */
.popover {
  transform-origin: var(--radix-popover-content-transform-origin);
}
/* Base UI */
.popover {
  transform-origin: var(--transform-origin);
}
/* モーダル(常に中央) */
.modal {
  transform-origin: center;
}

ユーザーが個別に気づくかどうかは問題ではありません。全体として、見過ごされた詳細は積み重なります。


スタッガーアニメーション

複数の要素が一緒に入場する場合、その出現をずらします。

.item {
  opacity: 0;
  transform: translateY(8px);
  animation: fadeIn 300ms ease-out forwards;
}
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
.item:nth-child(4) { animation-delay: 150ms; }

@keyframes fadeIn {
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

スタッガーの遅延は短く(アイテム間30-80ms)保ちます。スタッガーが再生されている間も、インタラクションをブロックしてはいけません。


CSSアニメーション(キーフレーム)

事前に決定された、動的でないアニメーションに使用します。キーフレームは中断時にゼロから再開するため、UIには避けてください。

@keyframes enter-right {
  from { opacity: 0; transform: translateX(16px); }
  to   { opacity: 1; transform: translateX(0); }
}
.enter {
  animation: enter-right 300ms ease-out forwards;
}

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

スプリングは実際の物理法則をシミュレートするため、持続時間ベースのアニメーションよりも自然に感じられます。中断時に速度を維持します。

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

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

Appleのアプローチ(推奨 – より理解しやすい)

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

従来の物理モデル(より制御可能)

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

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

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

import { useSpring } from 'framer-motion'

const springX = useSpring(mouseX * 0.1, { stiffness: 100, damping: 10 })

スプリングなし: 人工的に感じられ、瞬間的。スプリングあり: 自然に感じられ、勢いがある。


WEB ANIMATIONS API (WAAPI)

プログラムによるCSSアニメーション。ハードウェアアクセラレーションされ、中断可能で、ライブラリは不要です。

const element = document.querySelector('.card')

const animation = element.animate([
  { transform: 'scale(1)', opacity: 1 },
  { transform: 'scale(0.95)', opacity: 0.7 },
], {
  duration: 200,
  easing: 'cubic-bezier(0.23, 1, 0.32, 1)',
  fill: 'both',
})

animation.pause()
animation.play()
animation.reverse()
animation.finish()
animation.finished.then(() => console.log('done'))

WAAPIは高負荷時でもFramer Motionより優れています – メインスレッドの外で実行されます。CSSキーフレームでは不十分な、動的で中断可能なアニメーションに使用します。


スクロール駆動アニメーション

ブラウザサポートに関する注意: スクロール駆動アニメーション(animation-timeline: view() および scroll())は、2026年時点でChrome/Edgeのみであり、まだBaselineではありません。Firefox/SafariではIntersectionObserverを使用したJavaScriptフォールバックを提供してください。

ViewTimeline(要素がビューポートに出入りする)

@keyframes fade-up {
  from { opacity: 0; transform: translateY(20px); }
  to   { opacity: 1; transform: translateY(0); }
}
.reveal {
  animation: fade-up 600ms linear both;
  animation-timeline: view();
  animation-range: entry 0% entry 100%;
}

ScrollTimeline(ページスクロール位置)

@keyframes shrink {
  from { height: 80px; }
  to   { height: 50px; }
}
.site-header {
  animation: shrink 300ms linear both;
  animation-timeline: scroll();
  animation-range: 0 200px;
}

スクロール連動パララックス(バニラJS)

const layers = document.querySelectorAll('[data-parallax]')
window.addEventListener('scroll', () => {
  const scrollY = window.scrollY
  layers.forEach(layer => {
    const speed = parseFloat(layer.dataset.parallax) || 0.3
    layer.style.transform = `translateY(${scrollY * speed}px)`
  })
})

FLIPテクニック

レイアウトアニメーション用 – 位置やサイズが変わる要素のアニメーション。

function animateLayout(element, callback) {
  const first = element.getBoundingClientRect()
  callback()
  const last = element.getBoundingClientRect()

  const dx = first.left - last.left
  const dy = first.top - last.top
  const dw = first.width / last.width
  const dh = first.height / last.height

  element.animate([
    { transform: `translate(${dx}px, ${dy}px) scale(${dw}, ${dh})` },
    { transform: 'translate(0, 0) scale(1, 1)' },
  ], {
    duration: 300,
    easing: 'cubic-bezier(0.4, 0, 0.2, 1)',
  })
}

クリップパスによるアニメーション

CSSで最も強力なアニメーションツールの一つ。ハードウェアアクセラレーションされます。

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;
}
.visible {
  clip-path: inset(0 0 0 0);
}

使用用途: 長押し削除、スクロールに応じた画像表示、比較スライダー、タブでのシームレスな色の遷移。


知覚パフォーマンス

アニメーションの速度は、ユーザーが体験する応答性に直接影響します。

  • Enterアニメーションは遅く(ユーザーが操作を決定し、結果を待つ)
  • Exitアニメーションは速く(システムがユーザーのアクションに応答し、邪魔にならないようにする)
  • あなたが気づかない部分こそがチームにとっての違いを生む

アニメーションは補助的なものです。機能をブロックしてはいけません。操作が完了する前にアニメーションが終了していなければなりません。

/* 悪い例: アニメーションが操作をブロックする */
.modal {
  transition: opacity 500ms ease-out;
  pointer-events: none; /* アニメーション中は操作をブロック */
}

/* 良い例: アニメーションは操作をブロックしない */
.modal {
  transition: opacity 200ms ease-out;
}

アクセシビリティ

/* 動きの低減 */
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

これはWCAG 2.1を満たすために必須です。これにより、前庭障害を持つユーザーがアニメーションによる不快感を回避できます。

Individual skills in this repo

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

関連スキル