Skip to content

Apple App Performance Profiling

Diagnose slow, laggy, leaky, or battery-draining Apple apps using Instruments and MetricKit

Repository
MengTo/Skills
Stars
7,187
Licence
MIT
Files
10 files

What it does

When installed, the agent follows a structured playbook for finding and fixing performance problems in iPhone, iPad, and Mac apps. It picks the right Apple profiling tool for the symptom (such as Time Profiler for hangs and high CPU, Leaks and Allocations for memory, App Launch for slow starts, and Energy Log for battery drain), recommends profiling on a real device in Release builds, suggests a targeted fix, and checks the result with before-and-after measurements. It also adds a review checklist and sample MetricKit code for monitoring performance in production.

Great for

  • iOS or macOS developers chasing hangs, stutters, memory growth, or slow launches
  • Teams preparing a pre-release performance audit of an Apple app
  • Developers who want to add os_signpost timing or MetricKit production monitoring

Skip it if

  • Non-Apple platforms such as Android, web, or server code, since the guidance is specific to Apple tools like Instruments and Xcode
  • Users who only want to run the profilers themselves; the skill gives guidance and does not run Instruments for you

Try asking

  • “My SwiftUI list stutters when scrolling. Help me find the cause with Time Profiler.”
  • “Our app's memory keeps growing after navigating between screens. Walk me through finding leaks.”
  • “Cold launch takes about 4 seconds on device. Help me reduce it.”
  • “Prepare a pre-release performance audit for our iOS app.”
Step-by-step guide: how to use Apple App Performance ProfilingInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 10 original files, the MIT licence and an attribution note.

    performance-profiling.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip performance-profiling.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip performance-profiling.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent concrete symptoms and, if possible, trace or log excerpts so it picks the correct reference file.
  • Ask for a before-and-after measurement plan so fixes are verified rather than assumed.
  • Treat suggested code changes as drafts and test them on a Release build on a real device.

What's inside

  • agents/openai.yaml
  • demo/expected-output.md
  • demo/index.html
  • demo/input.md
  • demo/PROMPT.md
  • references/energy-diagnostics.md
  • references/launch-optimization.md
  • references/memory-profiling.md
  • references/time-profiler.md
  • SKILL.md

Redistributed unmodified from MengTo/Skills under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.