skills.rest
tuliopc23
tuliopc23COMMUNITY
Explore all skills by this author →
Website𝕏@tuliopinheiro_GitHub

axiom-hang-diagnostics

Diagnose application hangs by identifying main thread blocking with profiling tools.

Updated Dec 3, 2025
Search Tags:#performance#debugging#instruments#responsiveness#hangs#main thread
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-hang-diagnostics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: axiom-hang-diagnostics
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-hang-diagnostics
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-hang-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically diagnose and resolve app hangs, which occur when the main thread is blocked, making your application unresponsive.

Core Features & Use Cases

  • Identify Hang Causes: Differentiates between main thread busy and main thread blocked scenarios.
  • Tool Selection Guidance: Recommends appropriate debugging tools like Time Profiler and System Trace.
  • Diagnostic Interpretation: Assists in understanding hang reports from Xcode Organizer and MetricKit.
  • Use Case: When users report your app freezes or shows the "App not responding" dialog, use this Skill to pinpoint the cause, whether it's a long-running operation on the main thread or a deadlock.

Quick Start

Use the axiom-hang-diagnostics skill to analyze a hang report from Xcode Organizer.

Frequently Asked Questions about axiom-hang-diagnostics

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

FAQPage Schema
How do I diagnose app hangs caused by main thread blocking?▼

Diagnose app hangs by identifying whether the main thread is blocked or busy using profiling tools. This Skill provides systematic decision trees to differentiate synchronous I/O, notification handling, and lock contention hang patterns causing unresponsiveness.

What's the best way to interpret Xcode Organizer and MetricKit hang reports?▼

Interpret Xcode Organizer and MetricKit hang reports by analyzing main thread busy or blocked states. This Skill assists in reading profiling data to pinpoint long-running synchronous operations, deadlocks, and notification handling causing application freezes.

When should I use Time Profiler versus System Trace for debugging responsiveness issues?▼

Use Time Profiler and System Trace for debugging responsiveness issues based on hang type. This Skill recommends the appropriate Instruments tool to identify main thread blocking and busy states, guiding your profiling workflow for accurate hang resolution.

Why does my iOS app freeze and show the App not responding dialog?▼

Your app freezes and shows the App not responding dialog when the main thread is blocked by synchronous I/O, lock contention, or long-running operations. Use this Skill to systematically profile and resolve the exact hang cause.

Can I fix main thread busy states and deadlocks without advanced Instruments knowledge?▼

You can fix main thread busy states and deadlocks using this Skill's systematic decision trees, which guide you through Instruments like Time Profiler and System Trace. It provides workflow steps for interpreting hang reports without requiring prior advanced profiling expertise.

Related Skills

Explore More Software Engineering Skills→
DFly7DFly7

metrickit

Process MetricKit payloads for iOS performance and crash diagnostics.

Community
Advanced
Mithrandir21Mithrandir21

android-bug-hunting-anr-trace-analyzer

Analyze Android ANR trace logs to identify thread blocking and contention issues.

Community
Intermediate
FelixRauchFelixRauch

debugging-instruments

Debugs iOS app crashes and bottlenecks using LLDB and Xcode Instruments profiles.

Community
Advanced
tuliopc23tuliopc23

axiom-concurrency-profiling

Analyze Swift async/await performance and actor contention using Instruments.

Community
Advanced