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.