metrickit-diagnostics

Collects Apple MetricKit performance metrics and crash diagnostics with call stack trees.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers collect and analyze on-device performance metrics and crash diagnostics, enabling them to identify and resolve performance bottlenecks and stability issues in their applications.

Core Features & Use Cases

  • Metric Collection: Gathers daily aggregated metrics like CPU usage, memory, launch time, and network activity.
  • Diagnostic Reporting: Captures immediate diagnostics for crashes, hangs, disk writes, and CPU exceptions with call stack trees.
  • Custom Metrics: Allows developers to define and track custom performance intervals using signposts.
  • Use Case: Integrate this Skill into your app to automatically send performance data and crash reports to your analytics backend, allowing for proactive issue detection and resolution before users are significantly impacted.

Quick Start

Set up the MetricKit subscriber by adding MetricsSubscriber.shared.subscribe() in your application's initialization.

Frequently Asked Questions about metrickit-diagnostics

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

FAQPage Schema
How do I collect on-device performance metrics and crash diagnostics using MetricKit?

Collect on-device performance metrics and crash diagnostics by subscribing to MetricKit to handle MXMetricPayload and MXDiagnosticPayload, capturing CPU usage, memory data, crashes, and hangs. Initialize the subscriber with MetricsSubscriber.shared.subscribe() during app launch.

Can I track custom performance intervals with signposts in my app monitoring?

Track custom performance intervals by adding signpost metrics to your app monitoring workflow. This allows you to define and measure specific performance intervals beyond the daily aggregated metrics like launch time and network activity.

What types of crash and hang diagnostics can I capture with call stack trees?

Capture crash, hang, disk-write, and CPU exception diagnostics with call stack trees using MetricKit. These diagnostic payloads provide detailed stack traces to help identify and resolve stability issues proactively.

How do I upload app telemetry and crash reports to an analytics backend?

Upload app telemetry and crash reports to an analytics backend by processing the collected MXMetricPayload and MXDiagnosticPayload data. Integrate the Skill into your app to automatically send performance data for proactive issue detection.

Does MetricKit support daily aggregated metrics for app performance monitoring?

MetricKit supports daily aggregated metrics for app performance monitoring, including CPU usage, memory, launch time, and network activity. These metrics are delivered via MXMetricPayload for analysis.

Why do I need on-device crash reporting instead of relying solely on server-side logs?

On-device crash reporting captures immediate diagnostics with detailed call stack trees for crashes, hangs, and CPU exceptions, providing richer context than server-side logs to resolve performance bottlenecks before users are significantly impacted.