coreml-diag

Diagnose CoreML model loading, performance, and conversion issues on Apple devices.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill coreml-diag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coreml-diag
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-ios-ml/coreml-diag
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill coreml-diag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers diagnose and resolve common issues encountered with CoreML models, including load failures, performance bottlenecks, memory problems, accuracy degradation after compression, compute unit conflicts, and conversion errors.

Core Features & Use Cases

  • Load Failure Diagnosis: Identifies reasons for models not loading, such as unsupported versions or compute plan issues.
  • Performance Optimization: Analyzes slow inference and first-load times, suggesting fixes related to compute units and caching.
  • Accuracy & Compression Issues: Provides strategies for addressing accuracy loss after model compression techniques like palettization, quantization, and pruning.
  • Conversion Troubleshooting: Helps resolve errors during model conversion and identifies causes for output discrepancies.
  • Use Case: A developer's CoreML model is crashing on a specific device. This Skill can guide them through checking deployment targets, compute unit compatibility, and profiling on the actual device to pinpoint the cause.

Quick Start

Use the coreml-diag skill to troubleshoot a CoreML model that is failing to load.

Frequently Asked Questions about coreml-diag

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

FAQPage Schema
Why does my CoreML model fail to load on specific iOS devices?

CoreML model load failures often stem from unsupported deployment targets, compute plan issues, or compute unit incompatibilities. Profiling the model on the actual target device using Xcode Instruments helps pinpoint the specific loading failure cause.

How do I fix slow CoreML inference speed and high memory usage?

To fix slow CoreML inference speed and high memory usage, analyze first-load times and compute unit configurations. Caching strategies and optimizing compute unit selections provide actionable performance improvements for Apple device deployments.

How do I resolve CoreML accuracy degradation after model compression?

CoreML accuracy degradation after compression requires specific strategies for techniques like palettization, quantization, and pruning. Diagnosing the compression impact helps identify causes for output discrepancies and restore expected accuracy.

What is the best way to troubleshoot CoreML conversion errors?

The best way to troubleshoot CoreML conversion errors is to analyze the conversion pipeline for unsupported operations or output discrepancies. Using coremltools helps identify the root causes of conversion failures and provides debugging insights.

Can I use Xcode Instruments to debug CoreML performance bottlenecks?

Yes, you can use Xcode Instruments to debug CoreML performance bottlenecks. Profiling on the actual device identifies inference speed issues, memory usage spikes, and compute unit conflicts during model execution.

When do I need to check compute unit compatibility for CoreML deployment?

You need to check compute unit compatibility for CoreML deployment when models crash on specific devices or experience unexpected loading failures. Verifying deployment targets and compute plans ensures the model runs correctly across Apple devices.