ios-animation-code-review

What This Skill Does

The ios-animation-code-review skill is a specialized static analysis tool designed to audit Swift and SwiftUI animation code. It ensures that complex motion logic aligns with Apple's Human Interface Guidelines, performance best practices, and accessibility standards. By examining animation implementation patterns like PhaseAnimator, matchedGeometryEffect, and CAKeyframeAnimation, the skill identifies common pitfalls such as lack of Reduce Motion support, main-thread performance hitches, and incorrect usage of the withAnimation modifier. It serves as a rigorous peer-reviewer that enforces stability and UX consistency.

Installation

You can install this skill directly via the ClawHub command-line interface. Run the following command in your terminal within your OpenClaw environment: clawhub install openclaw/skills/skills/anderskev/ios-animation-code-review

Use Cases

• Pre-Pull Request Audits: Use this skill before merging complex UI work to ensure your team isn't introducing accessibility violations or performance bottlenecks.
• Refactoring Legacy Code: Identify deprecated .animation() modifiers that lack a value parameter, which is a common source of unexpected UI states.
• Performance Debugging: When your app experiences frame drops during scroll interactions, use this skill to check for expensive layout transitions or missing geometryGroup() modifiers.
• Complex Interaction Design: Validate custom transitions and matchedGeometryEffect implementations against naming namespace collisions and identity issues.

Example Prompts

1. "Review this CarouselView.swift file. I'm using matchedGeometryEffect for card expansions, but the transition feels jittery and sometimes skips frames. Can you check my implementation?"
2. "I just migrated our custom UI animations to PhaseAnimator. Please verify if my state transitions correctly handle accessibilityReduceMotion and ensure the loop logic is efficient."
3. "Take a look at this CABasicAnimation block in my view controller. Is there a performance risk using CATransaction here, or should I be using UIViewPropertyAnimator instead?"

Tips & Limitations

• Context is Key: Always provide the full view file or the relevant component structure, as the skill needs to see state property wrappers to accurately judge withAnimation scopes.
• Performance Focus: While the skill detects many issues, it cannot replace Instruments for real-time profiling. If it flags a performance issue, follow up with a Time Profiler capture.
• Accessibility First: The skill is strict about Reduce Motion. If your animation is critical to the user experience, ensure you have a non-animated fallback strategy implemented before the review.