Does this skill work for all xOS platforms?

Yes, it is designed for modern xOS development, including iOS, iPadOS, watchOS, and tvOS apps using the latest SwiftUI navigation patterns.

How can I debug deep links that aren't showing the right screen?

Deep link failures are typically timing or threading issues. This skill includes patterns to verify URL reception and ensure path modifications occur on the MainActor.

Why does my view pop back to the root immediately after pushing?

This is often caused by the NavigationPath state being recreated during a view render or a change in view identity. The skill helps identify where your @State is incorrectly localized.

Why is my SwiftUI NavigationLink not responding when tapped?

This usually occurs if the NavigationLink is placed outside the NavigationStack hierarchy or if the navigationDestination is inside a lazy container. This skill provides specific checks to verify view hierarchy and destination scope.

SwiftUI Navigation Diagnostics

Name: SwiftUI Navigation Diagnostics
Author: CharlesWiltgen

byCharlesWiltgen

•

233

•

Mobile Development

Diagnoses and resolves complex SwiftUI navigation issues, including path state management, view identity errors, and deep linking failures.

The axiom-swiftui-nav-diag skill is a specialized diagnostic tool designed to troubleshoot and fix common SwiftUI navigation failures. It provides a systematic framework for debugging NavigationStack and NavigationPath issues, helping developers resolve non-responsive links, unexpected pops, and state loss without resorting to complex UIKit wrappers. By following production-tested diagnostic patterns and a detailed decision tree, this skill identifies root causes such as misplaced navigation destinations, threading issues, and view identity changes in minutes.

主要功能

01Systematic path state management and logging patterns

02Deep link and state restoration debugging protocols

03Identification of view identity and placement errors

04233 GitHub stars

05MainActor and threading verification for navigation updates

06Comprehensive decision tree for rapid navigation troubleshooting

使用场景

01Resolving navigation state loss when switching between tabs or backgrounding an app

02Fixing 'ghost' pops where a view immediately returns to the root after being pushed

03Debugging deep links that fail to navigate to the correct screen on app launch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill