Can it help fix views that lose their state unexpectedly?

Absolutely. It includes a dedicated View Identity Investigation pattern to find where identity changes are causing state resets or animation failures.

When should I use this diagnostic skill over standard debugging?

Use this skill when basic troubleshooting fails, you encounter intermittent 'heisenbugs,' or you need to trace complex data flows using Xcode's SwiftUI Instruments.

Does this skill help with SwiftUI performance issues?

Yes, it specifically uses the Cause & Effect Graph in Instruments to identify broad dependencies and unnecessary view updates that cause dropped frames.

Is it compatible with @Observable and @StateObject?

Yes, it provides specific guidance for both modern @Observable (iOS 17+) and legacy ObservableObject patterns to ensure state is being observed correctly.

Does this skill require specific Xcode versions?

While many patterns work everywhere, the advanced profiling workflows recommend Xcode 16+ for the most accurate SwiftUI Instrument data.

SwiftUI Advanced Diagnostics

Name: SwiftUI Advanced Diagnostics
Author: CharlesWiltgen

byCharlesWiltgen

•

233

•

Mobile Development

Diagnoses complex SwiftUI state management issues, performance bottlenecks, and view lifecycle bugs using systematic workflows and Instruments integration.

SwiftUI Advanced Diagnostics is a specialized skill for Claude Code designed to solve difficult SwiftUI bugs that basic troubleshooting cannot resolve. It provides structured investigative patterns for addressing unexpected view updates, intermittent 'heisenbugs,' view identity resets, and environment-driven performance issues. By integrating with the SwiftUI Instrument and providing deep analysis of view update patterns, it helps developers move beyond trial-and-error toward data-driven bug resolution in modern xOS development.

Key Features

01Systematic diagnostic decision tree for complex SwiftUI view issues

02Deep integration with Xcode SwiftUI Instruments for cause-and-effect profiling

03Automated Self._printChanges() analysis to detect redundant or missing updates

04View Identity investigation patterns to fix state loss and animation glitches

05Environment dependency auditing to resolve cascading update bottlenecks

06233 GitHub stars

Use Cases

01Debugging a view that resets its state or loses text field focus unexpectedly

02Investigating performance lag and dropped frames during complex UI transitions

03Identifying why a view is failing to update despite underlying state changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add charleswiltgen/axiom axiom-swiftui-debugging-diag

For use in Claude.ai and ChatGPT

Download Skill