performance-profiling
Guide performance profiling with Instruments, diagnose hangs, memory issues, slow launches, and energy drain. Use when reviewing app performance or investigating specific bottlenecks.
npx skills add rshankras/claude-code-apple-skills --skill profiling --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Performance Profiling Systematic guide for profiling Apple platform apps using Instruments, Xcode diagnostics, and MetricKit. Covers CPU, memory, launch time, and energy analysis with actionable fix patterns. ## When This Skill Activates Use this skill when the user: - Reports app hangs, stutters, or dropped frames - Needs to profile CPU usage or find hot code paths - Has memory leaks, high memory usage, or OOM crashes - Wants to optimize app launch time - Needs to reduce battery/energy impact - Asks about Instruments, Time Profiler, Allocations, or Leaks - Wants to add `os_signpost` or performance measurement to code - Is preparing for App Store review and needs performance validation ## Decision Tree ``` What performance problem are you investigating? │ ├─ App hangs / unresponsive to taps / slow UI │ └─ Read time-profiler.md │ ├─ Scroll or animation stutter / dropped frames / hitches │ └─ Read hitches.md │ ├─ High memory / leaks / OOM crashes / growing footprint │ └─ Read memory-profiling.md │ ├─ Slow app launch / time to first frame │ └─ Read launch-optimization.md │ ├─ Battery drain / thermal throttling / background energy │ └─ Read energy-diagnostics.md │ ├─ General "app fee
- When This Skill Activates
- Decision Tree
- Quick Reference
- The 8 Key Metrics (WWDC21 10181)
- Process
- 1. Identify the Problem Category
- 2. Read the Appropriate Reference File
- 3. Profile on Real Hardware
- 4. Apply Fixes and Verify
- Xcode Diagnostic Settings
- MetricKit Integration
- Review Checklist
- Responsiveness
- Memory
What does the performance-profiling skill do?
Guide performance profiling with Instruments, diagnose hangs, memory issues, slow launches, and energy drain. Use when reviewing app performance or investigating specific bottlenecks.
How do I install it?
Run `npx skills add rshankras/claude-code-apple-skills --skill profiling --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From rshankras/claude-code-apple-skills, a repository with 589 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
