core-data-diag

Diagnose Core Data schema-migration crashes, thread-confinement errors, and N+1 query patterns.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill core-data-diag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-data-diag
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/core-data-diag
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill core-data-diag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This diagnostic skill helps identify schema migrations, concurrency errors, and N+1 query patterns, with guidance for safe migrations when bridging SwiftData and Core Data.

Core Features & Use Cases

  • Schema mismatch analysis and safe migration patterns
  • Concurrency/thread-confinement diagnostics
  • N+1 query profiling guidance for Core Data

Quick Start

Prompt: "Diagnose a migration crash after updating the data model."

Frequently Asked Questions about core-data-diag

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

FAQPage Schema
How do I diagnose Core Data migration crashes?

Core Data migration crashes often stem from schema mismatches between your data model and the persistent store. This Skill detects crash type, verifies store versus model versions, and applies safety-first migration patterns to preserve data during schema updates.

What causes thread-confinement errors in Core Data?

Thread-confinement errors occur when Core Data objects are accessed from threads other than the one that created them. This Skill analyzes threading violations, logs concurrent access patterns, and identifies which operations violate Core Data's thread-safety requirements.

How do I fix N+1 query problems in Core Data?

N+1 query patterns happen when fetching relationships individually instead of prefetching them, multiplying database round trips. This Skill profiles your queries, detects prefetch opportunities, and recommends relationship batching to reduce database calls and improve performance.

Can I bridge SwiftData and Core Data safely?

Bridging SwiftData and Core Data requires careful model alignment and migration testing. This Skill diagnoses bridging conflicts, validates data integrity across both frameworks, and enforces patterns that prevent schema and concurrency mismatches when mixing them.

What should I test before deploying a Core Data migration?

Safe migrations require verifying schema compatibility, testing with real production data, and checking for concurrency issues across devices. This Skill provides a diagnostic workflow covering crash detection, data preservation validation, and performance profiling on real devices and simulators.

Why is my Core Data app slow on production devices?

Slowdowns stem from N+1 queries, inefficient fetch requests, or excessive thread switching. This Skill logs SQL activity, analyzes query patterns, and profiles concurrency behavior to identify and fix performance bottlenecks specific to your device environment.