coreml-profile

Analyzes CoreML model execution on Apple Silicon to detect compute units, silent fallbacks, and bottlenecks.

57|18|Updated Jul 9, 2025
One-click install
npx skills add https://github.com/mattmireles/kokoro-coreml --skill coreml-profile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coreml-profile
Source: https://github.com/mattmireles/kokoro-coreml/tree/main/.claude/skills/coreml-profile
Command: npx skills add https://github.com/mattmireles/kokoro-coreml --skill coreml-profile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires coremltools, numpy, powermetrics, xctrace, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps identify the compute units (ANE, GPU, CPU) used by CoreML models, detect silent fallback, and uncover performance bottlenecks on Apple Silicon devices.

Core Features & Use Cases

  • Compute Unit Analysis: Determines which compute units are active, including ANE, GPU, and CPU.
  • Performance Bottlenecks: Identifies issues such as silent fallback and inefficient model usage.
  • Use Case: When you want to optimize your CoreML model's performance and understand its behavior on Apple Silicon hardware.

Quick Start

Profile the 'kokoro_decoder_har_post_30s.mlpackage' model for silent fallback and performance issues.

Frequently Asked Questions about coreml-profile

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

FAQPage Schema
How do I check which compute units my CoreML model is using on Apple Silicon?

To profile CoreML performance on Apple Silicon, this analyzes execution to identify active compute units including ANE, GPU, and CPU. It inspects the model to pinpoint exactly where operations run and detects silent fallback.

How do I detect silent fallback in a CoreML model?

Detecting silent fallback in CoreML models requires profiling execution to identify when operations unexpectedly shift from ANE or GPU to CPU. This analysis uncovers inefficient hardware usage and reveals hidden performance bottlenecks.

What's the best way to analyze CoreML performance bottlenecks on Apple Silicon?

Analyzing CoreML performance bottlenecks on Apple Silicon is best achieved by profiling model execution to map operations to specific compute units. This process identifies silent fallback and inefficient model usage causing slowdowns.

Do I need to export mlpackage files to profile my CoreML model?

Yes, you need to export mlpackage files to profile your CoreML model. This analysis requires the exported package format alongside profiling tools to determine compute unit activity and identify performance issues.

Can I use xctrace and powermetrics for CoreML model profiling?

Yes, xctrace and powermetrics can be used for CoreML model profiling. They serve as dependencies to analyze execution on Apple Silicon, determine active compute units, and uncover performance bottlenecks during inference.

Why does my CoreML model run slower on Apple Silicon than expected?

Your CoreML model may run slower due to silent fallback, where operations unexpectedly drop from ANE or GPU to CPU. Profiling execution identifies these compute unit shifts and uncovers hidden performance bottlenecks.