debugging-instruments

Diagnose iOS app crashes, memory leaks, and performance issues using LLDB and Instruments.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/harshav167/build-ios-apps --skill debugging-instruments-harshav167
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-instruments
Source: https://github.com/harshav167/build-ios-apps/tree/main/skills/debugging-instruments
Command: npx skills add https://github.com/harshav167/build-ios-apps --skill debugging-instruments-harshav167

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers debug iOS apps by guiding them through LLDB workflows, Memory Graph Debugger usage, and Instruments profiling to diagnose crashes, memory leaks, hangs, and performance issues.

Core Features & Use Cases

  • LLDB debugging workflows: print variables, step through code, inspect stack traces.
  • Memory and performance profiling with Instruments: Time Profiler, Allocations, Leaks, and Memory Graph Debugger.
  • Hang and crash diagnosis, API surface for performance tuning and triage on-device and in CI.

Quick Start

Start a debugging session on a running iOS app: attach LLDB, enable Instruments Time Profiler and Leaks, and review Memory Graph Debugger results to locate issues.

Frequently Asked Questions about debugging-instruments

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

FAQPage Schema
How do I diagnose iOS app memory leaks using the Memory Graph Debugger?

Diagnose iOS app memory leaks using the Memory Graph Debugger by attaching LLDB to a running app, capturing a memory graph snapshot, and reviewing retain cycles to locate leaked objects. This Skill provides structured workflows for inspecting memory graphs in Xcode.

What Instruments template should I use for profiling CPU performance hotspots in an iOS app?

For profiling CPU performance hotspots in an iOS app, use the Instruments Time Profiler template. This Skill guides you through enabling Time Profiler, recording a session, and analyzing call stacks to identify expensive functions.

Can I inspect variables and stack traces in Xcode using LLDB commands?

Yes, you can inspect variables and stack traces in Xcode using LLDB commands. This Skill provides structured guidance on printing variables, stepping through code, and inspecting stack traces to diagnose crashes during debugging sessions.

What is the best way to detect main-thread hangs in an iOS application?

The best way to detect main-thread hangs in an iOS application is by using the Instruments hang profiling template. This Skill outlines workflows for on-device hang detection and triage to isolate main-thread blocking issues.

Do I need a specific Xcode project setup to run iOS crash diagnosis with Instruments and LLDB?

You need an Xcode-based iOS project to run crash diagnosis with Instruments and LLDB. This Skill is applicable for analyzing crashes, memory leaks, and performance hotspots across standard Xcode-based iOS projects on-device and in CI.