axiom-audit-swiftui-nav

Analyze SwiftUI navigation architecture for deep linking and state restoration bugs.

34|2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/DengNaichen/Stet --skill axiom-audit-swiftui-nav
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-audit-swiftui-nav
Source: https://github.com/DengNaichen/Stet/tree/main/.agents/skills/axiom-audit-swiftui-nav
Command: npx skills add https://github.com/DengNaichen/Stet --skill axiom-audit-swiftui-nav

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies critical navigation flaws in SwiftUI applications, such as broken deep links, state loss, and improper navigation architecture that lead to poor user experiences.

Core Features & Use Cases

  • Architecture Mapping: Automatically maps your NavigationStack, NavigationSplitView, and TabView structures to visualize flow.
  • Anti-Pattern Detection: Scans for 10 common navigation pitfalls including missing path bindings, deprecated APIs, and state restoration gaps.
  • Health Scoring: Provides a quantitative assessment of your navigation robustness, helping you prioritize refactoring efforts.

Quick Start

Use the axiom-audit-swiftui-nav skill to perform a full navigation audit on the current project directory.

Frequently Asked Questions about axiom-audit-swiftui-nav

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

FAQPage Schema
How do I fix broken deep links and state restoration bugs in SwiftUI NavigationStack?

A SwiftUI navigation architecture audit detects deep linking failures, state restoration bugs, and architectural anti-patterns by evaluating NavigationStack containers, path bindings, and destination registration. It provides a health score to prioritize refactoring efforts for robust iOS routing.

What are common SwiftUI navigation anti-patterns causing state loss?

Common SwiftUI navigation anti-patterns include missing path bindings, deprecated navigation APIs, and state restoration gaps across NavigationStack and NavigationSplitView. Scanning for these pitfalls identifies architectural flaws causing state loss and poor user experiences during routing.

How do I audit a SwiftUI NavigationSplitView architecture for deep linking failures?

To audit SwiftUI NavigationSplitView architecture, analyze navigation containers, path usage, and destination registration across the codebase. This detects deep linking failures and architectural anti-patterns, validating navigation completeness against industry standards for robust iOS and macOS routing.

Does this navigation audit work with both iOS and macOS SwiftUI applications?

Yes, the navigation audit evaluates NavigationStack, NavigationSplitView, and TabView structures to validate navigation completeness against industry standards for robust iOS and macOS application routing. It works with both iOS and macOS SwiftUI applications to detect deep linking failures.

How do I map SwiftUI navigation flow across TabView and NavigationStack?

To map SwiftUI navigation flow, automatically map NavigationStack, NavigationSplitView, and TabView structures to visualize routing. This architecture mapping detects anti-patterns like missing path bindings and validates destination registration to identify state restoration bugs and deep linking failures.

Why does my SwiftUI state restoration fail when using NavigationStack path bindings?

SwiftUI state restoration fails due to architectural anti-patterns like missing path bindings or state restoration gaps in NavigationStack. An audit evaluates path usage and destination registration to detect these flaws, providing a health score to prioritize refactoring efforts.