axiom-uikit-animation-debugging

Diagnoses CAAnimation timing issues including handlers, durations, and frame-rate jank.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-uikit-animation-debugging-pradeepmouli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-uikit-animation-debugging
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-uikit-animation-debugging
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-uikit-animation-debugging-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CAAnimation issues manifest as missing completion handlers, wrong timing, or jank under specific conditions. Core principle 90% of CAAnimation problems are CATransaction timing, layer state, or frame rate assumptions, not Core Animation bugs.

Core Features & Use Cases

  • Systematic CAAnimation diagnosis with CATransaction patterns, frame rate awareness, and device-specific behavior.
  • Mandatory steps to diagnose: check completion, verify duration, inspect layer state, and pattern-driven fixes.
  • Use cases include diagnosing completion handlers, duration mismatches, and gesture-animation interactions across simulator and real devices.

Quick Start

Run through the mandatory diagnostics to identify and fix the CAAnimation timing issue on a real device.

Frequently Asked Questions about axiom-uikit-animation-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my CAAnimation completion handler never fire on a real device?

Missing CAAnimation completion handlers usually stem from incorrect CATransaction timing or layer state assumptions rather than Core Animation bugs. Systematic diagnosis verifies duration mismatches and device-specific frame rate interactions to pinpoint the root cause.

How do I diagnose UIKit animation jank and frame rate drops?

Diagnose UIKit animation jank by inspecting layer state, verifying CATransaction timing, and checking frame rate assumptions. This process identifies whether gesture-related interactions or duration mismatches are causing the degraded visual performance.

What is the best way to fix CAAnimation duration mismatches between simulator and real devices?

Fix CAAnimation duration mismatches by running mandatory diagnostics that examine CATransaction timing and verify layer state. Tailoring guidance to specific device characteristics ensures animation timing behaves consistently across both environments.

Can I use this approach to debug gesture-related animation timing interactions?

Yes, you can debug gesture-related animation timing interactions by applying pattern-driven fixes and verifying CATransaction timing. This addresses conflicts between gesture recognizers and running animations that cause unexpected timing behavior.

How do you inspect CATransaction timing to resolve animation issues?

Inspect CATransaction timing by running mandatory diagnostics to check completion handlers, verify durations, and examine layer state. This isolates whether the animation problem originates from transaction boundaries or frame rate discrepancies.