Skip to content

TheGoat395/Codex-Skills / skills/animation-jank-qa

animation-jank-qa

Verified

Diagnose a concrete rendered hitch or stutter.

FileKindSize
SKILL.mdskill md1.9 KB
agents/openai.yamlconfig266 B
references/animation-jank-qa-guide.mdmarkdown3.0 KB

references/animation-jank-qa-guide.md

View on GitHub
# Animation Jank QA Guide

## Purpose

- Make motion feel intentional, smooth, and respectful instead of fragile.

## Discovery Questions

- What motion is essential versus decorative?
- Which animations run on scroll, route change, hover, or load?
- How does reduced motion behave?
- Are transforms/opacity used instead of expensive layout changes?

## Implementation Rules

- Respect prefers-reduced-motion.
- Avoid scroll traps and mobile pinning dead zones.
- Prefer transform/opacity for frequent motion.
- Clean up timelines/listeners on route changes.
- Test rapid scroll and resize.

## Discriminate the cause

| Evidence in the failing interaction | Next probe |
|---|---|
| Long main-thread task overlaps the hitch | Inspect its call stack; isolate expensive render, parsing or script work |
| Repeated layout follows DOM writes | Separate measurement from mutation and compare the trace |
| Paint/raster dominates a large effect | Reduce its painted area or temporarily disable the effect in a diagnostic run |
| Jank begins after route return | Count active listeners, observers and timelines before/after remount |
| First reveal stalls but repeat does not | Compare asset decode, font readiness and initialization under matched cache conditions |

Change one plausible cause and repeat the original interaction under the same conditions. A diagnostic disabled effect is not an accepted visual repair until the intended result is restored and checked. Report traced causality separately from a visually smoother sample.

## Useful Patterns

- Reduced-motion static equivalent.
- ScrollTrigger refresh after images load.
- Hover/focus parity for important states.
- Performance pass for long-running loops.

## Anti-Patterns

- Motion hides content or blocks navigation.
- Pinned mobile section creates blank scroll.
- Infinite animation drains CPU.
- Reduced motion ignored.

## QA Checklist

- Inspect desktop/mobile scroll and resize.
- Toggle reduced motion if possible.
- Check console and performance symptoms.
- Verify route cleanup in SPA/Next apps.

## Acceptance Criteria

- Motion supports hierarchy and interaction.
- No obvious jank, scroll traps, or broken reduced-motion path remains.
- Animation risk is documented.

## Shared scope

For applicable substantial web work, reuse the [shared scoped web contract](../../website-operating-rules/references/scoped-web-contract.md) when available. Preserve current authorization, stack and requested scope; this optional reference does not require another planning or approval cycle.

## Official Source Anchors

- web.dev Web Vitals: https://web.dev/articles/vitals
- MDN Performance API: https://developer.mozilla.org/en-US/docs/Web/API/Performance_API
- Playwright screenshots: https://playwright.dev/docs/screenshots
- Playwright visual comparisons: https://playwright.dev/docs/test-snapshots
- Playwright emulation: https://playwright.dev/docs/emulation
- WCAG 2.2: https://www.w3.org/TR/WCAG22/
- MDN form validation: https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Forms/Form_validation
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall