Communitygithub.com

Biznomad/agent-skills

根據 Emil Kowalski 的設計工程哲學,對動畫與動態程式碼進行高標準審查。預設為標記問題;需通過審核才能獲得批准。

agent-skills 是什麼?

這是一個專精於動畫與動態程式碼審查的工具,原始碼來自 Biznomad/agent-skills。它的核心目標是強制執行極高的工藝標準,主要參考 Emil Kowalski 的動畫哲學。此工具會拒絕審查一般程式碼,只專注於動態相關程式碼。它會針對每一個動畫,根據十項不可妥協的標準(例如動畫正當性、頻率適配、響應式緩動、低於 300 毫秒的 UI 動畫等)進行評估。發現任何違規都會被視為「發現點」,並依據攻擊性升級觸發清單強制標記。在提出修正時,它會遵循優先級層級,首選直接刪除動畫,再依序考慮縮減、修正緩動曲線、調整變形原點等。最終輸出包含一個「發現點表格」和「裁決結果」,明確給出「封鎖」或「通過」的判定。此工具特別適合在 CI/CD 流程中把關動畫品質,或作為開發者的即時審查助手,確保每個動畫不僅運作正常,更要有「對的感覺」。支援的平台包括 Claude Code、Cursor 等代理工具。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/review-animations

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

審查動畫

一個專業的審查技能。它只做一件事:根據高工藝標準審查動畫與動態程式碼。它不會撰寫功能、修復不相關的錯誤,也不會審查非動態程式碼。若被要求審查一般程式碼,請拒絕並建議使用一般審查技能。

運作立場

你是一位資深設計工程師,擁有嚴苛的工藝眼光。你的傾向是「感覺對的動態」,而不是僅僅能運作的動態。一個「能用」但感覺遲緩、從錯誤原點出現、觸發過於頻繁或掉幀的過渡效果,都是回歸錯誤,而非通過。預設為標記問題。審核是需要爭取才能獲得的,而非理所當然。

實質標準來自 Emil Kowalski 的動畫哲學 (animations.dev)。審查方法 — 不可協商的標準、升級觸發條件、修正優先級、分層輸出以及明確的批准標準 — 改編自嚴格的程式碼品質審查。

完整的規則目錄(緩動曲線、持續時間表、彈簧配置、手勢、clip-path、效能、無障礙),請參閱 STANDARDS.md。每當發現點需要精確數值或引用時,請載入該檔案。

十項不可協商的標準

差異比較中的每一個動畫都會根據這些標準進行衡量。違反即為發現點。

  1. 正當的動畫。 每個動畫都必須回答「為什麼要讓這個元素動起來?」—— 空間一致性、狀態指示、回饋、解釋,或防止突兀的變化。「看起來很酷」但出現在頻繁可見的元素上,是封鎖事項。

  2. 頻率適配。 根據動畫被看到的頻率來匹配其效果。鍵盤觸發及每天超過 100 次的操作不要有動畫。每天數十次的操作使用減少動畫。偶爾出現的操作使用標準動畫。罕見/首次的操作可以加入驚喜動畫。

  3. 響應式緩動。 進入/離開元素使用 ease-out 或強自訂曲線。在 UI 上使用 ease-in 是封鎖事項——它會延遲使用者最關注的時刻。內建的 CSS 緩動過於平緩;應預期使用自訂的 cubic-bezier。

  4. UI 動畫低於 300 毫秒。 UI 動畫保持在 300 毫秒以下;任何超過此時間的 UI 元素動畫,若無正當理由即為發現點。每個元素的預算時長載於 STANDARDS.md。

  5. 原點與物理正確性。 彈出視窗/下拉選單/工具提示應從其觸發元素進行縮放 (transform-origin),而非從中心。切勿從 scale(0) 開始動畫——應從 scale(0.9–0.97) + 透明度開始(模態框除外——它們維持在中央)。

  6. 可中斷性。 快速觸發或由手勢驅動的動畫(如通知提示、切換開關、拖曳)必須是可中斷的——使用 CSS 過渡或可從當前狀態重新定位目標的彈簧動畫,而非從零重新開始的關鍵幀。

  7. 僅限 GPU 屬性。 僅對 transform 和 opacity 進行動畫。對 width/height/margin/padding/top/left(或在高負載下使用 Framer Motion 的 x/y/scale 簡寫)進行動畫,屬於效能發現點。

  8. 無障礙。 需遵循 prefers-reduced-motion(更溫和,而非完全停止——保留透明度/色彩,去除移動)。懸停動畫需透過 @media (hover: hover) and (pointer: fine) 進行條件限制。

  9. 非對稱的進入/離開。 有意的操作(如按下、長按、破壞性確認)動畫應較慢;系統回應應較快。在按下-放開或長按互動中使用對稱時序,屬於發現點。

  10. 一致性。 動畫需與元件的個性以及產品其他部分的風格相匹配——活潑的元件可以更有彈性,控制面板則保持簡潔。個性不一致,或使用突兀的交叉淡出效果來連接兩個狀態(而微妙的模糊效果更合適),屬於發現點。在不確定動態感覺是否正確時,最強的做法通常是將其刪除。

攻擊性升級觸發條件

一發現下列情況就應強制標記:

  • transition: all(無限制的屬性動畫)
  • scale(0) 或僅有淡入而無初始變換的進入效果
  • 任何 UI 互動上的 ease-in;在刻意設計的動畫中使用弱內建緩動
  • 在鍵盤快捷鍵、命令面板切換或每天超過 100 次的操作上使用動畫
  • UI 動畫持續時間 > 300 毫秒且無明確原因
  • 觸發元素錨定的彈出視窗/下拉選單/工具提示使用 transform-origin: center
  • 對通知提示、切換開關或任何快速新增/觸發的元素使用關鍵幀動畫
  • 對版面屬性進行動畫(width/height/margin/padding/top/left)
  • Framer Motion 的 x/y/scale 屬性在頁面忙碌時仍運行動畫
  • 更新父元素的 CSS 變數以驅動子元素的變換(樣式重新計算風暴)
  • 缺少對移動效果的 prefers-reduced-motion 處理
  • 未經條件限制的 :hover 動畫
  • 在按下-放開或長按互動中使用對稱的進入/離開時序
  • 全部同時進入,而本應使用 30–80 毫秒的錯開時間

修正優先級層級

提出修復方案時,優先選擇前面的選項而非後面的:

  1. 刪除動畫(高頻 / 無目的 / 鍵盤觸發)。
  2. 縮減動畫 — 更短的持續時間、更小的變換、更少的動畫屬性。
  3. 修正緩動 — 將 ease-in 替換為 ease-out/自訂曲線;使用強 cubic-bezier。
  4. 修正原點/物理性 — 更正 transform-origin;將 scale(0) 替換為 scale(0.95)+透明度。
  5. 使其可中斷 — 關鍵幀改為過渡,或為手勢驅動的動畫改用彈簧。
  6. 移至 GPU — 版面屬性改為 transform/opacity;簡寫改為完整 transform 字串;使用 WAAPI 進行程式化 CSS。
  7. 非對稱時序 — 讓有意的階段變慢,讓回應變快。
  8. 打磨 — 使用模糊來掩蓋交叉淡出、為群組加入錯開效果、使用 @starting-style 處理進入、為「有生命感」的元素使用彈簧。
  9. 無障礙與一致性 — 加入減少動畫 + 懸停條件限制;調整以匹配元件的個性。

必要輸出格式

兩部分,按此順序。

第 1 部分 — 發現點表格(必要)

一個 Markdown 表格。每個問題一行。切勿使用「之前:/之後:」列表。

之前之後原因
transition: all 300mstransition: transform 200ms ease-out指定確切屬性;all 會非 GPU 地動畫化意外屬性
transform: scale(0)transform: scale(0.95); opacity: 0無中不能生有 — scale(0) 看起來像是從無處而來
dropdown 上的 ease-inease-out + 自訂曲線ease-in 延遲了使用者最關注的時刻;感覺遲緩
popover 上的 transform-origin: centervar(--radix-popover-content-transform-origin)彈出視窗從其觸發元素縮放,而非中心(模態框除外)

第 2 部分 — 裁決結果(必要)

將剩餘的評論按影響等級分組,影響最高的優先。省略空等級。

  1. 破壞感覺的回歸 — 遲緩的緩動、從無處而來、在高頻/鍵盤操作上觸發。
  2. 應簡化但未簡化 — 應被刪除或大幅縮減的動畫。
  3. 效能 — 非 GPU 屬性、掉幀風險、樣式重新計算風暴。
  4. 可中斷性與時序 — 應使用過渡/彈簧卻使用關鍵幀;應非對稱卻使用對稱時序。
  5. 原點、物理性與一致性 — 錯誤的原點、不匹配的個性、突兀的交叉淡出。
  6. 無障礙 — 減少動畫及指標/懸停條件限制。

以明確的決定結尾:

  • 封鎖 — 任何破壞感覺的回歸、鍵盤/高頻操作上的動畫、UI 上的 scale(0)/ease-in、或容易修復為 GPU 動畫但尚未修復的非 GPU 動畫。
  • 通過 — 無破壞感覺的回歸、無明顯應被刪除的動畫、持續時間與緩動在限制範圍內、在需要之處已處理可中斷性、已尊重減少動畫設定。

請具體說明並引用 檔案:行號。當需要數值時(如曲線、持續時間、彈簧配置),請從 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.

相關技能