axiom-display-performance

Diagnose 60fps caps and frame pacing issues on ProMotion displays.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-display-performance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-display-performance
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-display-performance
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-display-performance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses issues where applications run at an unexpected frame rate, get stuck at 60fps on ProMotion displays, or experience frame pacing problems, ensuring a consistently smooth visual experience.

Core Features & Use Cases

  • Diagnose 60fps Bottlenecks: Identifies common reasons for being capped at 60fps on high-refresh-rate displays.
  • Render Loop Configuration: Guides on correctly setting up MTKView, CADisplayLink, and CAMetalDisplayLink for optimal performance.
  • System Cap Awareness: Explains how Low Power Mode, thermal throttling, and accessibility settings impact frame rates.
  • Frame Pacing & Hitches: Provides strategies to prevent micro-stuttering and understand render loop delays.
  • Use Case: If your game feels sluggish on a new iPad Pro despite targeting 120Hz, this Skill will help you pinpoint whether it's a configuration error, a system limitation, or a performance budget issue.

Quick Start

Use the axiom-display-performance skill to diagnose why my app is stuck at 60fps on ProMotion.

Frequently Asked Questions about axiom-display-performance

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

FAQPage Schema
Why is my app stuck at 60fps on a ProMotion display?

Apps are often capped at 60fps on ProMotion displays due to render loop configuration errors with MTKView or CADisplayLink, or system-level constraints like Low Power Mode restricting frame rates.

How do I configure CADisplayLink for optimal 120Hz frame rates?

To configure CADisplayLink for optimal frame rates, ensure your render loop correctly targets the maximum refresh rate and account for system caps that may throttle performance under thermal pressure or Low Power Mode.

What causes frame pacing issues and hitches in iOS rendering?

Frame pacing issues and hitches are caused by render loop delays and configuration errors in MTKView or CAMetalDisplayLink, preventing frames from syncing correctly with the display refresh cadence.

Do system settings like Low Power Mode limit frame rate performance?

Yes, system settings like Low Power Mode, thermal throttling, and accessibility configurations impose strict frame rate caps, limiting your app's maximum achievable fps regardless of ProMotion support.

What is the best way to diagnose 60fps bottlenecks on iPad Pro?

The best way to diagnose 60fps bottlenecks is to inspect your render loop configuration in MTKView or CAMetalDisplayLink and verify whether system constraints or performance budget issues are limiting the display.

Does CAMetalDisplayLink work with ProMotion displays for high refresh rates?

Yes, CAMetalDisplayLink works with ProMotion displays to achieve high refresh rates, provided it is configured correctly to avoid frame pacing problems and not limited by thermal throttling or Low Power Mode.