skills.rest
kyoya1123
kyoya1123COMMUNITY
Explore all skills by this author →
𝕏@kyoya1123GitHub

instruments-profiler

Profile Xcode Instruments traces to identify performance bottlenecks in iOS and macOS apps.

10|1|Updated Jan 31, 2026
Search Tags:#profiling#ios#macos#instruments#symbolication#performance-analysis#xctrace
One-click install
npx skills add https://github.com/kyoya1123/instruments-profiler --skill instruments-profiler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: instruments-profiler
Source: https://github.com/kyoya1123/instruments-profiler/tree/main
Command: npx skills add https://github.com/kyoya1123/instruments-profiler --skill instruments-profiler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Manually profiling iOS and macOS apps in Instruments is slow, error-prone, and difficult to turn into clear optimization actions. This Skill automates the full workflow so you can move from a running app to a readable performance report without wrestling with the GUI.

Core Features & Use Cases

  • Device selection and launch control: Detects simulators and connected devices, then helps choose the best target for profiling.
  • Release-build profiling: Builds optimized Release artifacts, runs the right xctrace template, and symbolicates results with dSYM files.
  • Actionable analysis: Extracts hot frames, hangs, hitches, SwiftUI update patterns, memory leaks, allocations, and energy usage into Markdown reports.
  • Use cases: Diagnose slow app launch, track CPU hotspots in SwiftUI views, investigate memory growth, or measure battery impact on real devices.

Quick Start

Ask Claude to profile your app with Instruments so it can select a device, build a Release version, run the appropriate template, and return a symbolicated optimization report.

Frequently Asked Questions about instruments-profiler

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

FAQPage Schema
How do I automate Instruments profiling for an iOS app without using the Xcode GUI?▼

Automating Instruments profiling involves using the xctrace command-line tool to build a Release version, run templates like Time Profiler or Allocations, and export XML data for analysis. This Skill orchestrates that entire workflow end to end.

Can I profile SwiftUI animation hitches and hangs on a physical device?▼

Yes, profiling SwiftUI animation hitches and hangs on connected physical devices is supported. The Skill detects connected devices, runs the appropriate xctrace template, and symbolicates the results using dSYM files to identify problematic frames.

What's the best way to symbolicate Instruments traces to find CPU hotspots?▼

The best way to symbolicate Instruments traces for CPU hotspots is to build an optimized Release version, run the Time Profiler template via xctrace, and apply dSYM symbolication to extract readable hot frames for optimization.

How do I investigate memory leaks and allocations growth in a macOS app?▼

Investigating memory leaks and allocations in a macOS app requires running the Leaks and Allocations xctrace templates against a Release build. This Skill automates this process and extracts the memory issues into a readable Markdown report.

Does this profiling workflow require a Release build to measure app launch performance?▼

Yes, measuring app launch performance accurately requires a Release build. This Skill builds optimized Release artifacts to ensure the profiling data reflects real-world performance before running the xctrace templates.

Why does my Energy Log profiling show incomplete data without dSYM symbolication?▼

Energy Log profiling data appears incomplete without dSYM symbolication because the raw memory addresses cannot be mapped back to human-readable function names. This Skill automatically applies dSYM files to resolve hot frames and energy usage patterns.

Related Skills

Explore More Software Engineering Skills→
r1cA18r1cA18
4

ios-device-build

Automate Swift/iOS app builds, installs, and launches on physical devices.

Community
Advanced
software-mansionsoftware-mansion
1.9k

argent-native-profiler

Profile iOS apps with xctrace and analyze exported traces for CPU, hang, and leak bottlenecks.

Official
Intermediate
conorluddyconorluddy
179

crash-debugging

Symbolicate iOS crash logs with dSYM files to identify root causes.

Community
Intermediate
gustavscirulisgustavscirulis
114

performance-profiling

Guides users through diagnosing app performance issues with Xcode Instruments and MetricKit.

Community
Advanced