axiom-uikit-animation-debugging

Use when CAAnimation completion handler doesn't fire, spring physics look wrong on device, animation duration mismatches actual time, gesture + animation interaction causes jank, or timing differs between simulator and real hardware - systematic CAAnimation diagnosis with CATransaction patterns, frame rate awareness, and device-specific behavior

1. Zainstaluj skill w swoim projekcie Claude/Copilot, wskazując katalog axiom-uikit-animation-debugging z repozytorium.

2. Gdy napotkasz problem z animacją CAAnimation (completion handler nie pali się, czas trwania nie zgadza się z rzeczywistością, animacja wygląda źle na urządzeniu), uruchom skill i opisz symptomy — na przykład "completion handler pali się w symulatorze, ale nie na urządzeniu" lub "spring animation jankuje na starszych iPhone'ach".

3. Skill przeprowadzi cię przez obowiązkowe pierwsze kroki diagnostyczne: dodanie print statement'ów do completion handlera, aby sprawdzić czy w ogóle się pali, oraz sprawdzenie czy self nie stał się nil z powodu weak reference.

4. Skill analizuje CATransaction timing i layer state — najczęstsze przyczyny problemów. Zwraca uwagę na założenia dotyczące frame rate'u, które mogą być poprawne w symulatorze (60Hz), ale zawodzą na rzeczywistych urządzeniach (zmienny frame rate, throttling CPU).

5. Skill zaleca testowanie na rzeczywistym urządzeniu (najstarszym wspieranym modelem) przed wdrożeniem — symulator ukrywa wiele problemów czasowania, które ujawniają się w produkcji.

6. Na podstawie diagnostyki skill sugeruje konkretne poprawki: zmianę CATransaction konfiguracji, dostosowanie timing parameters lub refaktoryzację interakcji między gestami a animacjami.