Communitygithub.com

FerroxLabs/murage

CSSアニメーションやトランジション、Web Animations API、Framer Motion、GSAP、スクロール駆動アニメーション、レイアウトアニメーション、スプリング物理、動きの抑制設定、パフォーマンス予算などを網羅したWebアニメーション専門スキル。

murage とは?

このスキルは、パフォーマンスとアクセシビリティを犠牲にすることなく、ユーザー体験を向上させる、目的を持ったWebアニメーションを設計・実装するための包括的なガイドです。CSSトランジションや@keyframes、Framer Motion、GSAP、スクロール駆動アニメーションなど、主要なアニメーションツールとパターンを網羅し、適切な手法を選択するための判断基準を提供します。アニメーション設計の原則(目的、持続時間、イージング、スターガー)や、60fpsを維持するためのパフォーマンス予算、`prefers-reduced-motion`に対応するアクセシビリティの実装方法についても詳しく説明します。React(Framer Motion)とVue(<Transition>)の両方をサポートし、複雑なタイムラインシーケンスにはGSAP、インタラクティブなジェスチャーにはスプリング物理を推奨するなど、ユースケースに応じた実践的なアドバイスを提供します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/FerroxLabs/murage/tree/HEAD/skills-library/animation-designer

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

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

ドキュメント

アニメーションデザイナー

目的

パフォーマンスやアクセシビリティを犠牲にすることなく、ユーザー体験を向上させる、パフォーマンスが高く目的を持ったWebアニメーションを設計および実装します。このスキルは、アニメーションツール、パターン、そして適切なアプローチを選択するための判断フレームワークをカバーします。

アニメーションツールの選択

判断マトリックス

アニメーションのニーズ                         推奨ツール
--------------------------------------------------------------
シンプルなホバー/フォーカス効果              CSSトランジション
キーフレームシーケンス(ローディングなど)     CSS @keyframes
コンポーネントの出現/退出アニメーション        Framer Motion (React)
                                                Vue <Transition> (Vue)
スクロールトリガーによる表示                  CSSスクロール駆動アニメーション
                                                (または Intersection Observer)
複雑なタイムラインシーケンス                  GSAP
SVGパスアニメーション                         GSAP または CSS
スプリング/物理ベースのモーション            Framer Motion (spring)
レイアウトアニメーション(位置/サイズ)       Framer Motion (layoutId)
ジェスチャー駆動(ドラッグ、ピンチ)          Framer Motion (drag)
共有要素トランジション                        View Transitions API
データ可視化アニメーション                    D3 トランジション または GSAP
マイクロインタラクション(アイコン、トグル)  CSS または Lottie

CSSトランジション

基本

/* トランジションのショートハンド: プロパティ 持続時間 タイミング関数 遅延 */
.button {
  background: var(--color-brand);
  transition: background 200ms ease-out, transform 150ms ease-out;
}
.button:hover {
  background: var(--color-brand-hover);
  transform: scale(1.02);
}

/* 個別のプロパティ */
.card {
  transition-property: transform, box-shadow, opacity;
  transition-duration: 200ms, 300ms, 200ms;
  transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
}

/* 名前付きタイミング関数 */
--ease-in:        cubic-bezier(0.4, 0, 1, 1);     /* 加速 */
--ease-out:       cubic-bezier(0, 0, 0.2, 1);     /* 減速 */
--ease-in-out:    cubic-bezier(0.4, 0, 0.2, 1);   /* 標準 */
--ease-spring:    cubic-bezier(0.34, 1.56, 0.64, 1); /* オーバーシュート */

よくあるトランジションパターン

/* フェードイン/アウト */
.fade-enter { opacity: 0; }
.fade-enter-active { opacity: 1; transition: opacity 300ms ease-out; }
.fade-exit { opacity: 1; }
.fade-exit-active { opacity: 0; transition: opacity 200ms ease-in; }

/* 下からスライドアップ */
.slide-up {
  transform: translateY(20px);
  opacity: 0;
  transition: transform 300ms ease-out, opacity 200ms ease-out;
}
.slide-up.active {
  transform: translateY(0);
  opacity: 1;
}

/* スケルトンローディングのきらめき */
@keyframes shimmer {
  0% { background-position: -200% 0; }
  100% { background-position: 200% 0; }
}
.skeleton {
  background: linear-gradient(90deg, #e0e0e0 25%, #f0f0f0 50%, #e0e0e0 75%);
  background-size: 200% 100%;
  animation: shimmer 1.5s ease-in-out infinite;
}

CSS @keyframes

/* スピナー */
@keyframes spin {
  to { transform: rotate(360deg); }
}
.spinner {
  animation: spin 1s linear infinite;
  border: 3px solid var(--color-border);
  border-top-color: var(--color-brand);
  border-radius: 50%;
  width: 24px; height: 24px;
}

/* パルス(注意喚起インジケーター) */
@keyframes pulse {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.5; }
}
.notification-dot {
  # ... (省略) ...
.list-item:nth-child(2) { animation-delay: calc(1 * 50ms); }
.list-item:nth-child(3) { animation-delay: calc(2 * 50ms); }

/* または style 属性を使用: style="--i: 3" */
.list-item {
  animation-delay: calc(var(--i) * 50ms);
}

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

/* スクロール位置に基づいてアニメーション */
@keyframes reveal {
  from {
    opacity: 0;
    transform: translateY(40px) scale(0.95);
  }
  to {
    opacity: 1;
    transform: translateY(0) scale(1);
  }
}

/* 要素がビューポートに入ったときにトリガー */
.reveal-on-scroll {
  animation: reveal linear both;
  animation-timeline: view();
  animation-range: entry 0% entry 50%;
}
# ... (省略) ...
  to { transform: translateY(-50px); }
}

.parallax-element {
  animation: parallax linear;
  animation-timeline: scroll();
}

Framer Motion (React)

基本パターン

import { motion, AnimatePresence } from 'framer-motion';

// 出現アニメーション
function Card() {
  return (
    <motion.div
      initial={{ opacity: 0, y: 20 }}
      animate={{ opacity: 1, y: 0 }}
      transition={{ duration: 0.3, ease: 'easeOut' }}
    >
      <h2>カードコンテンツ</h2>
    </motion.div>
  );
}

// 退出アニメーション(AnimatePresence が必要)
function Modal({ isOpen, onClose }: ModalProps) {
  return (
    # ... (省略) ...
        <motion.li key={item.id} variants={itemVariants}>
          {item.name}
        </motion.li>
      ))}
    </motion.ul>
  );
}

スプリング物理

// スプリングアニメーション(自然な物理ベースの動き)
<motion.div
  animate={{ x: 100 }}
  transition={{
    type: 'spring',
    stiffness: 300,   // 高いほどキビキビ
    damping: 20,      // 高いほどバウンドが少ない
    mass: 1,          // 高いほど慣性が大きい
  }}
/> .// プリセット
const springPresets = {
  snappy:  { type: 'spring', stiffness: 400, damping: 25 },
  bouncy:  { type: 'spring', stiffness: 300, damping: 10 },
  gentle:  { type: 'spring', stiffness: 120, damping: 14 },
  molasses: { type: 'spring', stiffness: 60, damping: 20 },
};

// スプリングとイージングの使い分け:
// スプリング: インタラクティブ要素、ドラッグ、レイアウト変更(自然に感じられる)
// イージング: シンプルなトランジション、出現/退出(予測可能に感じられる)

レイアウトアニメーション

// 自動レイアウトアニメーション
function ExpandableCard({ expanded }: { expanded: boolean }) {
  return (
    <motion.div layout className={expanded ? 'card-expanded' : 'card-collapsed'}>
      <motion.h2 layout="position">タイトル</motion.h2>
      {expanded && (
        <motion.p
          initial={{ opacity: 0 }}
          animate={{ opacity: 1 }}
          exit={{ opacity: 0 }}
        >
          ここに展開されたコンテンツが入ります。
        </motion.p>
      )}
    </motion.div>
  );
}

# ... (省略) ...
            {item.title}
          </motion.div>
        ))}
      </div>
    </LayoutGroup>
  );
}

ジェスチャーアニメーション

// ドラッグ
<motion.div
  drag
  dragConstraints={{ top: -100, bottom: 100, left: -100, right: 100 }}
  dragElastic={0.2}
  whileDrag={{ scale: 1.1, cursor: 'grabbing' }}
/> .// ホバーとタップ
<motion.button
  whileHover={{ scale: 1.05 }}
  whileTap={{ scale: 0.95 }}
  transition={springPresets.snappy}
>
  クリックしてね
</motion.button> .// スクロールトリガー(useInView を使用)
# ... (省略) ...
      animate={isInView ? { opacity: 1, y: 0 } : {}}
      transition={{ duration: 0.6, ease: 'easeOut' }}
    >
      {children}
    </motion.div>
  );
}

GSAP (複雑なタイムライン)

import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';

gsap.registerPlugin(ScrollTrigger);

// タイムラインシーケンス
const tl = gsap.timeline({ defaults: { ease: 'power2.out', duration: 0.5 } });

tl.from('.hero-title', { y: 60, opacity: 0 })
  .from('.hero-subtitle', { y: 40, opacity: 0 }, '-=0.3')   // 0.3秒オーバーラップ
  .from('.hero-cta', { scale: 0.8, opacity: 0 }, '-=0.2')
  .from('.hero-image', { x: 100, opacity: 0 }, '-=0.4');

// スクロールトリガーアニメーション
gsap.from('.feature-card', {
  scrollTrigger: {
    trigger: '.features-section',
    start: 'top 80%',
    # ... (省略) ...
  const ctx = gsap.context(() => {
    // ここにすべてのGSAPアニメーションを記述
    gsap.from('.item', { opacity: 0, y: 20, stagger: 0.1 });
  }, containerRef);

  return () => ctx.revert();  // すべてのアニメーションをクリーンアップ
}, []);

動きの抑制設定

実装

/* CSS: ユーザーの設定をグローバルに尊重 */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
// React: useReducedMotion フック
function useReducedMotion(): boolean {
  const [reduced, setReduced] = useState(false);

  useEffect(() => {
    const mq = window.matchMedia('(prefers-reduced-motion: reduce)');
    setReduced(mq.matches);
    const handler = (e: MediaQueryListEvent) => setReduced(e.matches);
    mq.addEventListener('change', handler);
    return () => mq.removeEventListener('change', handler);
  }, []);

  return reduced;
}

// 使用例
function AnimatedCard() {
  const reduced = useReducedMotion();
# ... (省略) ...
      コンテンツ
    </motion.div>
  );
}

// Framer Motion 組み込み (v6以降)
import { useReducedMotion } from 'framer-motion';

アニメーションのパフォーマンス予算

目標: アニメーションは60fpsを維持すること(1フレームあたり16.67ms)

ルール:
  1. transform と opacity のみをアニメーションさせる(コンポジターのみのプロパティ)
  2. width、height、top、left、margin、padding のアニメーションは避ける
  3. will-change は控えめに使う(メモリオーバーヘッドが増える)
  4. 同時にアニメーションさせる要素は約10~15個に制限する
  5. JS駆動のアニメーションには requestAnimationFrame を使用する
  6. スクロールハンドラはデバウンスする(またはCSSスクロール駆動アニメーションを使用する)
  7. 他の要素のレイアウトをトリガーする要素のアニメーションは避ける

測定:
  - Chrome DevTools > Performance > Frame chart
  - 目標: 16msを超えるフレームがないこと
  - レイアウトスラッシング(強制リフローの指標)を確認する

最適化テクニック:
  - transform: translateZ(0) または will-change を使用してレイヤーを昇格させる
  - アニメーションコンテナには contain: layout paint を使用する
  - 画面外のアニメーションコンテンツには content-visibility: auto を使用する
  - 非表示のときはアニメーションを一時停止する(Intersection Observer)

アニメーション設計の原則

1. 目的: すべてのアニメーションは機能を果たさなければならない
   - 注意を誘導する
   - 関係性を示す(親子、前後)
   - フィードバックを提供する(クリック、ホバー、成功、エラー)
   - 空間的な方向性を維持する(コンテンツがどこから来たか)
   - 知覚される待ち時間を短縮する

2. 持続時間のガイドライン:
   マイクロインタラクション(ホバー、トグル):  100-200ms
   出現アニメーション:                         200-400ms
   退出アニメーション:                         150-300ms(出現より速く)
   ページトランジション:                       300-500ms
   複雑なシーケンス:                           500-1000ms 合計

3. イージング:
   出現: ease-out(減速 -- 素早く現れて、落ち着く)
   退出: ease-in(加速 -- ゆっくり始まり、素早く去る)
   移動: ease-in-out(自然な動き)
   連続: linear(スピナー、プログレス)

4. スターガー:
   リストアイテム間: 30-80ms(アイテム数が多いほど速く)
   スターガーの最大合計持続時間: ~500ms(20+アイテムの場合でも)

アニメーションアーキテクチャチェックリスト

  • 複雑さのニーズに基づいてアニメーションツールが選択されている
  • シンプルなホバー/フォーカス効果にはCSSトランジションが使用されている
  • ループアニメーションやローディングアニメーションにはCSS @keyframesが使用されている
  • 出現/退出/レイアウトアニメーションにはFramer Motionまたは同等のものが使用されている
  • 複雑なタイムラインシーケンスにはGSAPが使用されている
  • すべてのアニメーションが60fpsを維持している(DevToolsで確認済み)
  • transformとopacityのみがアニメーションされている(レイアウトプロパティはなし)
  • prefers-reduced-motionがグローバルに尊重されている
  • アニメーションの持続時間がUXガイドライン(100-500ms)に従っている
  • スターガーのタイミングが妥当な合計時間に制限されている
  • すべてのアニメーションに明確な目的がある(装飾的でない)
  • インタラクティブ/ジェスチャーアニメーションにはスプリング物理が使用されている
  • スクロール駆動アニメーションは、サポートされている場合CSS APIを使用している
  • GSAPアニメーションはコンポーネントのアンマウント時にクリーンアップされる
  • will-changeはアクティブなアニメーション中にのみ使用される

使用タイミング

このスキルを使用する場合:

  • アニメーションデザイナーソリューションの設計または実装時
  • 既存のアニメーションデザイナーアプローチのレビューまたは改善時
  • アニメーションデザイナーに関するアーキテクチャまたは実装の決定時
  • アニメーションデザイナーのパターンとベストプラクティスの学習時
  • アニメーションデザイナー関連の問題のトラブルシューティング時

このスキルを使用しない場合:

  • 質問が根本的に異なる技術ドメインに関する場合
  • より具体的な兄弟スキルが必要なトピックを正確にカバーしている場合
  • 専門家のガイダンスではなく、完全なハンズオンチュートリアルが必要な場合

出力形式

# アニメーションデザイナー分析

## コンテキスト評価
[状況の要約と制約]

## 推奨アプローチ
[根拠を含む主要な推奨]

## 実装手順
1. [具体的な詳細を含む手順]
2. [具体的な詳細を含む手順]
3. [具体的な詳細を含む手順]

## トレードオフと考慮事項
- [主要なトレードオフ 1]
- [主要なトレードオフ 2]

## 次のステップ
- [即時のアクションアイテム]
- [フォローアップのアクションアイテム]

例

入力: 「中規模の本番アプリケーション向けにアニメーションデザイナーを実装するのを手伝ってください」

出力: 現在の状態評価、具体的なパターンを用いた推奨アニメーションデザイナーアプローチ、マイルストーンを含む実装ロードマップ、そしてアプリケーションの規模と制約に合わせたリスク軽減戦略をカバーする構造化された分析。

エッジケース

  • レガシーシステムとの統合: アニメーションデザイナーがレガシーなアプローチと共存しなければならない場合、完全な書き換えではなく段階的な移行パスを提供する
  • 規模の不一致: ソリューションの複雑さがプロジェクトの規模を超えている場合、よりシンプルなアプローチを推奨し、再検討すべきタイミングをメモする
  • チームのスキルギャップ: チームに推奨アプローチの経験がない場合、学習リソースとよりシンプルな代替案を含める
  • 競合する要件: 制約が競合する場合(例:パフォーマンス vs 保守性)、トレードオフを明示的に述べ、指定された優先順位に基づいて推奨する

Individual skills in this repo

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

FerroxLabs/murage

Writes board-level narrative updates that complement financial reports with strategic context, competitive positioning, key risks, and forward-looking guidance for board of directors audiences. Use when the user needs to write a board update, board meeting narrative, or director-level briefing. Do NOT use for stakeholder updates to management (use `stakeholder-update`), investor emails (use `investor-update-email`), or full business reports (use `business-report`).

FerroxLabs/murage

>- End-to-end workflow for building a professional photography portfolio from niche selection through shooting, editing, website creation, and client acquisition. Covers gear decisions, shooting technique, post-processing workflow, portfolio curation, online presence, and the transition from hobbyist to working photographer. Use when the user wants to build photography portfolio or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

>- End-to-end workflow for creating a high-converting SaaS landing page from copywriting through design, development, SEO optimization, and analytics setup. Covers persuasion frameworks, responsive design, performance optimization, and conversion tracking to turn visitors into customers. Use when the user wants to build saas landing page or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Calculates startup burn rate (gross and net), projects cash runway in months, and builds scenario analysis for different spending and revenue trajectories. Use when the user asks about burn rate, cash runway, how long their money will last, or startup cash management. Do NOT use for personal savings calculations (use budget-planning), full financial modeling (use financial-model-structure), or fundraising narrative (use fundraising-narrative).

FerroxLabs/murage

The user is asking \"how long do we have,\" \"can we afford this hire,\" or \"are we running out.\" Load whenever cash, burn, or time-to-zero shows up — or when a spending decision is on the table and the user doesn't know how many months it costs.

FerroxLabs/murage

Professional corporate video production guidance covering training videos, promotional content, testimonials, and product demos. Includes client brief templates, script approval workflows, achieving professional quality on budget, brand compliance, stakeholder management, and delivery specifications. Use when the user asks about corporate video or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Helps artists, designers, and creative professionals curate, organize, and present their work through compelling portfolios across digital platforms, personal websites, and print formats for career advancement. Use when the user asks about creative portfolio builder, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio builder or requires a different specialized skill.

FerroxLabs/murage

Cross-discipline creative portfolio assessment evaluating artistic cohesion, technical skill, presentation quality, and market positioning. Produces a scored evaluation with recommendations for strengthening creative identity and professional opportunity. Use when the user asks about creative portfolio evaluator, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio evaluator or requires a different specialized skill.

FerroxLabs/murage

Professional design portfolio evaluation assessing design process, craft quality, range of work, presentation, and industry alignment. Produces a scored review with recommendations for strengthening design practice and career positioning. Use when the user asks about design portfolio reviewer, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of design portfolio reviewer or requires a different specialized skill.

FerroxLabs/murage

Teaches specific named emotional regulation techniques (the STOP technique, urge surfing, cognitive reframing, emotional labeling, opposite action, and physiological soothing) with step-by-step sequences. Gathers the user's emotional challenges and triggers, then produces a personalized regulation toolkit with technique instructions and a situation-response plan. Use when the user asks about managing emotions, controlling anger, handling frustration, emotional regulation strategies, or building emotional resilience. Do NOT use for clinical emotional dysregulation treatment, personality disorder management, or replacing professional mental health support.

FerroxLabs/murage

Structures a fundraising narrative for startup investors covering traction, market size, business model, use of funds, and milestone targets using standard VC pitch structure. Use when the user asks about fundraising pitch, investor narrative, raising capital, pitch deck story, or investment memo. Do NOT use for sales pitch decks (use sales-pitch-deck), personal loan applications, grant proposals (use grant-proposal-writing), or financial model creation (use financial-model-structure).

FerroxLabs/murage

Interactive storytelling for games covering branching narratives, dialogue trees, environmental storytelling, lore design, character writing for games, quest design, player agency, world-building for interactive media, and narrative integration with game mechanics. Use when the user asks about game narrative writer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Writes Instagram captions with a hook line, story body, hashtag strategy, and platform-optimized call-to-action. Use when the user wants to write an Instagram caption, create Instagram content, or draft text to accompany an Instagram post or reel. Do NOT use for LinkedIn posts (use `linkedin-post`), Twitter threads (use `twitter-thread`), or blog posts (use `blog-post-writing`).

FerroxLabs/murage

Produces conversion-optimized landing page copy with hero section, problem statement, solution, social proof, and CTA sections using conversion copywriting methodology. Use when the user asks to write landing page copy, create a product page, write a sales page, draft conversion copy, or write landing page text for a website. Also useful when asked to write website copy or create a page that converts visitors. Do NOT use for ad copy (use paid-ad-copy), product descriptions for e-commerce listings (use product-description), or full website content strategy (use seo-content-strategy).

FerroxLabs/murage

Guides the user through launching a professional art or creative portfolio from curation through outreach, chaining 5 atomic skills across career-development, design-creative, and writing categories. Covers physical vs. digital portfolio, platform selection, fine art vs. commercial positioning, and curated vs. comprehensive approaches. Use when the user wants to create and launch a portfolio to attract clients, galleries, or employers. Do NOT use for building a job search portfolio in non-creative fields (use land-new-job workflow), personal brand content strategy (use build-personal-brand workflow), or creating the artwork itself.

FerroxLabs/murage

>- Complete YouTube channel launch workflow from niche selection and channel strategy through video production, editing, monetization setup, community building, and personal brand development for sustainable channel growth. Use when the user wants to launch youtube channel or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Run a section-by-section conversion teardown of one landing page — hero, value proposition, social proof, features, objection handling, CTA and footer — plus form, mobile and page-speed audits, ending in prioritised fixes split into quick wins, strategic and long-term, with A/B test hypotheses. Use when one page has traffic and is not converting. Do NOT use for a whole-site marketing audit (use market-audit), for the copy voice and awareness-stage decisions behind it (use copy-awareness-stages) or for the visual system it should sit inside (use mira-visual-system).

FerroxLabs/murage

Comprehensive motion graphics guidance covering title design, lower thirds, animated explainers, kinetic typography, logo animation, After Effects and Apple Motion workflows, design principles for motion, storyboarding for motion, and building a motion design practice. Use when the user asks about motion graphics or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Game narrative design covering branching dialogue systems, world lore construction, environmental storytelling techniques, character arc design for interactive media, player agency and consequence systems, quest narrative structure, narrative documentation, and integration with game mechanics. Use when the user asks about narrative designer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Comprehensive animation guidance covering the 12 principles of animation, 2D and 3D production pipelines, tools (Blender, After Effects, Procreate, Toon Boom), frame rates, rigging, motion graphics vs character animation, and building an animation practice from concept to final render. Use when the user asks about animation creator or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

関連スキル