debugging-instruments

Diagnose iOS app crashes and performance issues using LLDB, Memory Graph Debugger, and Instruments.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill debugging-instruments-dfly7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-instruments
Source: https://github.com/DFly7/iOS-FastAPI-Supabase-AI/tree/main/.agents/skills/debugging-instruments
Command: npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill debugging-instruments-dfly7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnosing and profiling iOS apps to quickly identify crashes, memory leaks, hangs, and performance bottlenecks using LLDB, Memory Graph Debugger, and Instruments.

Core Features & Use Cases

  • LLDB debugging workflows for Swift/ObjC on real devices and simulators
  • Memory Graph Debugger analyses to detect retain cycles and leaks
  • Instruments templates (Time Profiler, Allocations, Leaks, Network) for in-depth profiling
  • Hang diagnostics and main-thread analysis during complex UI interactions
  • Build failure triage guidance during CI and local development

Quick Start

Run a profiling session from Xcode, reproducing the issue while LLDB and Instruments collect data.

Frequently Asked Questions about debugging-instruments

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

FAQPage Schema
How do I debug an iOS app crash using LLDB?

Debug an iOS app crash using LLDB by setting breakpoints and inspecting variables to trace the fault. The Skill guides Swift and Objective-C workflows on simulators and real devices to reproduce the issue and capture structured diagnostic data safely.

What is the best way to find memory leaks in an iOS app?

Finding memory leaks in an iOS app is best achieved by analyzing the memory graph to detect retain cycles. The Skill provides structured guidance on using the Memory Graph Debugger and Instruments templates like Leaks to pinpoint and resolve memory issues.

How do I profile main-thread hangs during complex UI interactions?

Profile main-thread hangs during complex UI interactions by running Instruments time profiling sessions. The Skill offers validated diagnostic steps to identify performance bottlenecks and slow rendering while reproducing the UI interactions in Xcode.

Can I use Instruments to triage build failures during local development?

Instruments is not typically used to triage build failures, but the Skill provides specific guidance for build failure triage during CI and local development. It covers validated diagnostic steps for crashes and performance issues across profiling sessions.

When should I use the Memory Graph Debugger versus the Allocations template?

Use the Memory Graph Debugger to capture retain cycles and leaks at a specific point in time, while the Allocations template tracks object lifecycle and memory growth over a profiling session. The Skill guides structured analysis using both tools to ensure safe debugging.

Does this Skill support debugging iOS apps on real devices?

This Skill supports debugging iOS apps on real devices and simulators. It provides structured LLDB workflows and tool-specific best practices to ensure safe debugging without altering app behavior across development and profiling sessions.