performance-profiling

Guide performance profiling for Apple platform apps using Instruments and MetricKit.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill performance-profiling-autisticaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-profiling
Source: https://github.com/AutisticAF/claude-code-apple-dev-plugin/tree/main/skills/performance-profiling
Command: npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill performance-profiling-autisticaf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematically help developers find and fix performance problems in Apple platform apps, including CPU hotspots, memory leaks, slow launches, UI hangs, and excessive energy usage so apps run smoothly for users.

Core Features & Use Cases

  • Guided Instrument Workflows: Step-by-step instructions for Time Profiler, Allocations, Leaks, App Launch, and Energy Log to collect meaningful traces on physical devices.
  • Diagnosis & Fix Patterns: How to interpret call trees, memory graphs, and MetricKit payloads with concrete remediation patterns (e.g., move work off main thread, downsample images, defer initialization).
  • Production Monitoring Guidance: MetricKit integration examples and os_signpost usage to gather repeatable telemetry from real users.
  • Use Case: When a user reports dropped frames or OOM crashes, run the Time Profiler and Allocations workflows, identify the hot functions or retain cycles, apply fixes, and re-profile to verify improvements.

Quick Start

Ask the performance-profiling skill to analyze a reported slow UI hang by collecting Instruments traces on a physical device, running Time Profiler and Allocations, and returning an actionable remediation checklist.

Frequently Asked Questions about performance-profiling

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

FAQPage Schema
How do I profile an iOS app for high CPU usage and UI hangs?

To profile high CPU usage and UI hangs, run the Time Profiler workflow in Instruments on a physical device using a Release build. This Skill provides step-by-step instructions to collect traces, interpret call trees, and apply remediation patterns like moving work off the main thread.

What's the best way to find memory leaks causing OOM crashes in macOS apps?

The best way to find memory leaks causing OOM crashes is using the Allocations and Leaks instruments. This Skill guides you through collecting memory graphs on physical devices to identify retain cycles and apply fixes like deferring initialization.

How does MetricKit integration work for monitoring Apple platform app performance?

MetricKit integration works by gathering repeatable telemetry from real users to monitor production performance. This Skill provides integration examples and os_signpost usage guidance to capture diagnostic payloads for CPU, memory, and energy issues.

Can I use Instruments to diagnose slow app launch times on watchOS and tvOS?

Yes, you can use the App Launch instrument to diagnose slow launch times across watchOS and tvOS. This Skill offers workflows for investigating launch issues on physical devices using Release builds to ensure accurate profiling.

Why should I use a Release build on a physical device for performance profiling?

You should use a Release build on a physical device for performance profiling because Debug builds include different compiler optimizations that mask real bottlenecks. This Skill emphasizes profiling with Release configurations to capture meaningful traces and verify improvements accurately.