debugging-instruments

Debug iOS apps with LLDB, Memory Graph Debugger, and Instruments.

155|22|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/omarshahine/HomeClaw --skill debugging-instruments-omarshahine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-instruments
Source: https://github.com/omarshahine/HomeClaw/tree/main/.agents/skills/debugging-instruments
Command: npx skills add https://github.com/omarshahine/HomeClaw --skill debugging-instruments-omarshahine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers diagnose and fix issues in iOS applications, including crashes, memory leaks, performance bottlenecks, and build failures.

Core Features & Use Cases

  • Debugging: Utilize LLDB for step-by-step code execution, breakpoint management, and variable inspection.
  • Memory Analysis: Employ the Memory Graph Debugger and Instruments (Allocations, Leaks) to identify and resolve memory issues like retain cycles.
  • Performance Profiling: Use Instruments (Time Profiler, Core Animation) to pinpoint performance bottlenecks and optimize CPU, memory, and rendering.
  • Build Triage: Understand and resolve common build errors, especially those related to Swift Package Manager dependencies.
  • Use Case: When an app is crashing intermittently on a specific screen, use LLDB to set breakpoints, inspect the state, and analyze the call stack to find the root cause. If the app is slow, use Time Profiler to identify the heaviest functions.

Quick Start

Use LLDB to set a breakpoint at line 42 in ViewModel.swift and print the value of the count variable.

Frequently Asked Questions about debugging-instruments

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

FAQPage Schema
How do I find memory leaks and retain cycles in my iOS app?

To find memory leaks and retain cycles in an iOS app, use Xcode's Memory Graph Debugger and Instruments (Allocations, Leaks). These tools inspect object reference graphs to identify and resolve memory that is allocated but never released.

What is the best way to profile iOS app performance and fix slow rendering?

The best way to profile iOS app performance and fix slow rendering is to use Instruments templates like Time Profiler and Core Animation. Time Profiler pinpoints CPU bottlenecks in heavy functions, while Core Animation identifies main thread hangs and rendering issues.

Can I use LLDB to inspect variables and analyze an intermittent iOS crash?

Yes, you can use LLDB to diagnose an intermittent iOS crash by setting breakpoints, executing code step-by-step, and inspecting variable states. Analyzing the call stack during a crash session helps pinpoint the root cause of the failure.

Does this debugging approach work for both Swift and Objective-C codebases?

Yes, these debugging and profiling techniques support both Swift and Objective-C codebases. LLDB commands, Instruments templates, and the Memory Graph Debugger apply common debugging patterns to diagnose crashes and performance issues across both languages.

How do I resolve Swift Package Manager build failures during iOS development?

To resolve Swift Package Manager build failures, you must triage common dependency errors using diagnostic tools. Analyzing build logs and inspecting package dependencies helps identify and fix integration issues causing the build to fail.