TheGoat395/Codex-Skills / skills/animation-jank-qa
animation-jank-qa
VerifiedDiagnose a concrete rendered hitch or stutter.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.9 KB |
| agents/openai.yaml | config | 266 B |
| references/animation-jank-qa-guide.md | markdown | 3.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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |