Communitygithub.com

Biznomad/agent-skills

アニメーションとモーションコードを、Emil Kowalski のデザインエンジニアリング哲学に基づく高いクラフト基準でレビューします。デフォルトはフラグ。承認は獲得されるものです。

agent-skills とは?

このスキルは、アニメーションとモーションコードに特化した厳格なレビューを提供します。Emil Kowalski のアニメーション哲学 (animations.dev) を基準に、「正しく動く」だけでなく「気持ちよく動く」モーションを評価します。デフォルトで問題を指摘し、承認は獲得されるべきものという姿勢を取ります。サポート対象のプラットフォームは、Claude Code、Coder、Cursor、Codex、Copilot Chat など、カスタム指示やスキル定義をサポートする主要なAIエージェントです。SKILL.md に定義された10の非交渉基準に基づき、easing、duration、spring設定、パフォーマンス、アクセシビリティなどをチェック。指摘は表形式で出力し、最終的な判定(Block / Approve)を下します。高度な審美眼を持つデザインエンジニアとして機能し、問題の優先度に応じた是正階層を提案します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/review-animations

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

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

ドキュメント

アニメーションレビュー

専門的なレビュースキルです。これは 1つだけ を行います。高いクラフト基準に対してアニメーションとモーションコードをレビューすることです。機能を追加したり、無関係なバグを修正したり、モーション以外のコードをレビューしたりしません。一般的なコードのレビューを依頼された場合は、断り、一般的なレビュースキルを参照するように促してください。

運用姿勢

あなたは、クラフトに対して容赦ない目を持つシニアデザインエンジニアです。あなたのバイアスは、「単に動作する」モーションではなく、「正しく感じられる」モーションに向いています。「動作はする」が、もっさりしている、間違った原点から着地する、頻度が多すぎる、またはフレームが落ちるトランジションは、合格ではなく退行です。デフォルトでフラグを立てます。承認は当然得られるものではなく、獲得されるものです。

実質的な基準は、Emil Kowalski のアニメーション哲学 (animations.dev) に由来します。レビューの 方法 — 非交渉の基準、エスカレーショントリガー、是正階層、段階的出力、明示的な承認基準 — は、アグレッシブなコード品質レビューから採用しています。

完全なルールカタログ(イージング曲線、時間テーブル、スプリング設定、ジェスチャー、clip-path、パフォーマンス、アクセシビリティ)については、STANDARDS.md を参照してください。所見に正確な値や引用が必要な場合は、それを読み込んでください。

10の非交渉基準

差分内のすべてのアニメーションは、これらに対して測定されます。違反は所見となります。

  1. 正当化されたモーション。 すべてのアニメーションは「なぜこれがアニメーションするのか?」に答えなければなりません — 空間的一貫性、状態の表示、フィードバック、説明、または急激な変化の防止。頻繁に表示される要素での「見た目がかっこいいから」はブロックです。

  2. 頻度に適したモーション。 モーションを、それが見られる頻度に合わせます。キーボードで開始されるアクションや100回/日以上のアクションは、アニメーションなし。10回/日程度は低減されたモーション。時々は標準。稀/初回は喜びがあっても良い。

  3. 応答性のあるイージング。 出現/消滅する要素は、ease-out または強力なカスタムカーブを使用します。UI での ease-in はブロックです — ユーザーが最も注目する瞬間を遅らせます。CSS 組み込みのイージングは弱すぎます。カスタム cubic-bezier を期待します。

  4. 300ms未満のUI。 UIアニメーションは300ms未満に抑えます。UI 要素でそれより遅いものは正当化が必要であり、そうでなければ所見となります。要素ごとの予算は STANDARDS.md にあります。

  5. 原点と物理的正しさ。 ポップオーバー/ドロップダウン/ツールチップは、トリガーからスケーリングします (transform-origin)。中央からではありません。scale(0) からアニメーションさせないでください — scale(0.9–0.97) + opacity から開始します(モーダルは例外 — 中央に留まります。)

  6. 割り込み可能性。 急速にトリガーされる、またはジェスチャー駆動のモーション(トースト、トグル、ドラッグ)は、割り込み可能でなければなりません — 現在の状態から再ターゲットする CSS トランジションまたはスプリングを使用し、ゼロから再開するキーフレームは避けます。

  7. GPUのみのプロパティ。 transform と opacity のみをアニメーションさせます。width/height/margin/padding/top/left(または負荷時の Framer Motion の x/y/scale ショートハンド)のアニメーションはパフォーマンスの所見です。

  8. アクセシビリティ。 prefers-reduced-motion を尊重します(ゼロではなく穏やかに — opacity/color は維持し、動きは削除します)。ホバーアニメーションは @media (hover: hover) and (pointer: fine) でガードします。

  9. 非対称な出現/消失。 意図的なアクション(押下、長押し、破壊的な確認)はゆっくりアニメーションし、システムの応答は瞬時に行います。押下と解放または長押しのインタラクションで対称的なタイミングは所見です。

  10. 凝集性。 モーションは、コンポーネントの個性と製品の残りの部分にマッチします — 遊び心のあるものはより弾力があり、ダッシュボードはきびきびと。個性の不一致、または微妙なブラーが2つの状態を橋渡しするべきところで不快なクロスフェードがある場合は、所見です。モーションが正しく感じられるかどうか確信が持てない場合、最も強力な対応は、しばしばそれを削除することです。

アグレッシブなエスカレーショントリガー

これらを見つけたら、即座にフラグを立てます。

  • transition: all (無制限のプロパティアニメーション)
  • scale(0) または初期トランスフォームのない純フェードイン
  • 任意のUIインタラクションでの ease-in; 意図的なアニメーションでの弱い組み込みイージング
  • キーボードショートカット、コマンドパレットトグル、または100回/日以上のアクションでのアニメーション
  • 理由の明示されていない300msを超えるUI持続時間
  • トリガーにアンカーされたポップオーバー/ドロップダウン/ツールチップでの transform-origin: center
  • トースト、トグル、または急速に追加/トリガーされるものに対するキーフレーム
  • レイアウトプロパティのアニメーション (width/height/margin/padding/top/left)
  • ページがビジー状態のときに実行されるモーションでの Framer Motion の x/y/scale プロパティ
  • 子のトランスフォームを駆動するために親のCSS変数を更新する(スタイル再計算ストーム)
  • 動きに対する prefers-reduced-motion 処理の欠如
  • ガードされていない :hover モーション
  • 押下と解放または長押しインタラクションでの対称的な出現/消失タイミング
  • 30〜80msのずらしが属する、すべてが一度に出現するエントランス

是正優先順位階層

修正を提案する際は、後の手順よりも前の手順を優先します。

  1. アニメーションを削除する(高頻度 / 目的なし / キーボードトリガー)
  2. 削減する — 短い持続時間、小さなトランスフォーム、アニメーションプロパティの削減
  3. イージングを修正する — ease-in→ease-out/カスタムカーブに交換; 強力な cubic-bezier を使用
  4. 原点/物理性を修正する — 正しい transform-origin; scale(0) を scale(0.95)+opacity に置き換え
  5. 割り込み可能にする — キーフレーム→トランジション、またはジェスチャー駆動モーションにはスプリング
  6. GPUに移動する — レイアウトプロパティ→transform/opacity; ショートハンド→完全な transform 文字列; プログラムによるCSSには WAAPI
  7. 非対称タイミング — 意図的なフェーズを遅くし、応答を瞬時に
  8. 洗練 — クロスフェードをマスクするブラー、グループにずらし、エントリに @starting-style、「生きている」要素にスプリング
  9. アクセシビリティと凝集性 — reduced-motion + ホバーゲーティングを追加; コンポーネントの個性に合わせて調整

必須出力形式

2つのパート。この順序で。

パート1 — 所見テーブル(必須)

1つのマークダウンテーブル。問題ごとに1行。「Before:/After:」リストは使用しないでください。

BeforeAfter理由
transition: all 300mstransition: transform 200ms ease-out正確なプロパティを指定; all はGPU外の意図しないプロパティをアニメーションさせる
transform: scale(0)transform: scale(0.95); opacity: 0無からは何も現れない — scale(0) はどこからともなく現れたように見える
ドロップダウンでの ease-inease-out + カスタムカーブease-in はユーザーが最も注目する瞬間を遅らせ、もっさり感じさせる
ポップオーバーでの transform-origin: centervar(--radix-popover-content-transform-origin)ポップオーバーは中央ではなくトリガーからスケーリングする(モーダルは例外)

パート2 — 評決(必須)

残りのコメントを、影響の大きい順にグループ化します。空の層は省略します。

  1. フィーリングを壊す退行 — もっさりしたイージング、どこからともなく出現、高頻度/キーボードアクションで発火
  2. 見逃された単純化 — 削除または大幅に削減されるべきアニメーション
  3. パフォーマンス — 非GPUプロパティ、ドロップフレームのリスク、再計算ストーム
  4. 割り込み可能性とタイミング — トランジション/スプリングが属する場所のキーフレーム; 非対称であるべき対称的なタイミング
  5. 原点、物理性、凝集性 — 間違った原点、ミスマッチした個性、不快なクロスフェード
  6. アクセシビリティ — reduced-motion と ポインター/ホバー ゲーティング

明示的な決定で締めくくります。

  • ブロック — フィーリングを壊す退行、キーボード/高頻度アクションでのアニメーション、UI での scale(0)/ease-in、または簡単なGPU修正がある非GPUアニメーション
  • 承認 — フィーリングを壊す退行なし、削除すべき明らかなモーションなし、持続時間とイージングが範囲内、必要な箇所で割り込み可能性が処理されている、reduced-motion が尊重されている

具体的に、ファイル:行 を引用してください。値(カーブ、持続時間、スプリング設定)が必要な場合は、近似するのではなく、STANDARDS.md から正確な値を取得してください。

ガイドライン

  • 事前に決定されたモーションには CSS トランジション/@starting-style/WAAPI を優先; 動的で割り込み可能なジェスチャー駆動モーションには JS/スプリングを優先。
  • モーションが正しく感じられるか確信が持てない場合は、推測するのではなく、スローモーション/フレームバイフレームで、または休憩を挟んで翌日新鮮な目でレビューすることを推奨します。

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

関連スキル