Communitygithub.com

Biznomad/agent-skills

根据 Emil Kowalski 的设计工程理念,对动画和动效代码进行高水准审查。默认标记问题,通过审批才算合格。

agent-skills 是什么?

该技能专注于审查动画和动效代码,遵循 Emil Kowalski(来自 animations.dev)所倡导的严格设计工程标准。它仅处理动画审查,不会编写新功能、修复无关错误或审查非动效代码。该技能定义了十项不可协商的标准,涵盖动画合理性、频率适配、缓动函数、持续时间、物理正确性、可中断性、GPU 属性、可访问性、非对称进出以及整体协调性。用户可以通过 [STANDARDS.md](STANDARDS.md) 查阅完整的规则目录,包括缓动曲线、持续时间表、弹簧配置、手势处理、性能及可访问性等方面的精确数值。 审查过程包括一个“发现项表格”,其中列出“修改前”、“修改后”代码及“原因”,以及一个按影响等级(从感觉破坏性回归到可访问性问题)分组的“裁决”部分。最终会明确给出“阻止”或“批准”的决定。该技能可在任何 AI 代理平台(如 Claude Code、Cursor 或 Codex)上使用,通过加载其 SKILL.md 文件来激活。

兼容平台~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)。审查方法——不可协商的标准、升级触发条件、修复优先级层次、分级输出以及明确的批准标准——改编自激进的代码质量审查。

完整的规则目录(缓动曲线、持续时间表、弹簧配置、手势、裁剪路径、性能、可访问性),请参阅 STANDARDS.md。每当发现项需要精确数值或引用时,请加载该文件。

十项不可协商的标准

差异中的每个动画都需对照这些标准进行衡量。违反即构成发现项。

  1. 合理动效。 每个动画必须回答“为什么这个元素需要动画?”——空间一致性、状态指示、反馈、解释,或防止突兀变化。高频元素上的“看起来很酷”是阻塞项。

  2. 频率适配。 根据元素被看到的频率调整动效。键盘触发及每天100+次的操作不应有动画。每天数十次的操作使用减弱动效。偶尔使用的操作可使用标准动效。罕见/首次使用的操作可以加入愉悦效果。

  3. 响应式缓动。 进入/离开的元素使用 ease-out 或强自定义曲线。UI 上使用 ease-in 是阻塞项——它会延迟用户最关注的时刻。内置的 CSS 缓动太弱;应使用自定义三次贝塞尔曲线。

  4. UI 动效 < 300ms。 UI 动画控制在 300ms 以内;任何超过此时间的 UI 元素动效需要提供理由,否则视为发现项。每个元素的预算请参考 STANDARDS.md。

  5. 原点与物理正确性。 弹出框/下拉菜单/提示框应从其触发器缩放(transform-origin),而非中心。切勿从 scale(0) 开始动画——应从 scale(0.9–0.97) + 透明度开始(模态框例外——它们保持居中)。

  6. 可中断性。 快速触发或手势驱动的动效(如通知条、开关、拖拽)必须可中断——使用 CSS 过渡或能从当前状态重新定位目标的弹簧,而非从零重新开始的 @keyframes。

  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 持续时间 > 300ms 且未说明原因
  • 触发器锚定的弹出框/下拉菜单/提示框使用 transform-origin: center
  • 对通知条、开关或任何快速添加/触发的元素使用 @keyframes
  • 对布局属性(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/自定义曲线;使用强的三次贝塞尔曲线。
  4. 修复原点/物理性——更正 transform-origin;将 scale(0) 替换为 scale(0.95)+透明度。
  5. 使其可中断——将 @keyframes 改为过渡,或为手势驱动的动效使用弹簧。
  6. 迁移至 GPU——布局属性改为 transform/opacity;简写属性改为完整的 transform 字符串;对程序化 CSS 使用 WAAPI。
  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) 看起来像从不知名的地方出现
下拉菜单上的 ease-inease-out + 自定义曲线ease-in 延迟了用户最关注的时刻;感觉迟钝
弹出框上的 transform-origin: centervar(--radix-popover-content-transform-origin)弹出框应从触发器缩放,而非中心(模态框例外)

第 2 部分 —— 裁决(必需)

将剩余的评论按影响等级分组,从最高等级开始。省略空等级。

  1. 感觉破坏性回归 —— 缓动迟钝、来源不明、在高频/键盘操作上触发。
  2. 遗漏的简化 —— 应删除或大幅减弱的动画。
  3. 性能 —— 非 GPU 属性、掉帧风险、重算风暴。
  4. 可中断性与时机 —— 本应使用过渡/弹簧的地方使用了 @keyframes;应对称但不对称的时机。
  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.

相关技能