axiom-display-performance

Diagnose and optimize frame-rate issues on ProMotion devices via render loop configuration and MetricKit telemetry.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers diagnose and optimize frame-rate issues on ProMotion and other high-refresh displays, enabling predictable, smooth rendering across devices.

Core Features & Use Cases

  • Diagnose render loop misconfigurations (MTKView, CADisplayLink) and identify causes of 60fps ceilings.
  • Provide guidance for frame pacing, latency control, and telemetry integration (MetricKit) across iOS/macOS apps.
  • Apply to games, UI-intensive apps, and animations that require stable high-frame-rate rendering.

Quick Start

Follow the diagnostic steps to tune your render loop for ProMotion devices and apply the recommended frame-rate configurations.

Frequently Asked Questions about axiom-display-performance

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

FAQPage Schema
Why is my MTKView capped at 60fps on ProMotion devices?

ProMotion frame-rate optimization involves configuring MTKView and CADisplayLink to enable dynamic refresh rates. It requires explicit frame-rate control and system-awareness to maintain smooth rendering without draining battery.

How do I configure CADisplayLink for optimal frame pacing in iOS animations?

Integrating MetricKit telemetry into your render loop captures real-time frame-rate and performance data. This provides production measurement capabilities to verify frame pacing stability and identify thermal or power-related drops.

Does this approach work with CAMetalDisplayLink for macOS apps?

Dynamic frame-rate management throttles rendering speed during Low Power or Thermal states. It prevents performance degradation by making the render loop system-aware, ensuring stable frame pacing under hardware constraints.

What is the best way to measure render loop performance in production?

The best way to measure production render loop performance is integrating MetricKit telemetry. This captures real-time frame-rate data to verify stability and diagnose issues across high-refresh displays.