Skip to main content
skill CX Codex

ios-navigation · hoangnguyen0403 — Claude Code skill: what it does, how to install

ios-navigation guides SwiftUI navigation and deep linking setups with NavigationStack, NavigationPath, and Universal Links.

MIT 1 installs ★ 585 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a claude-code
Open on GitHub

What ios-navigation does

This skill provides architecture constraints for iOS 16+ navigation in SwiftUI. It triggers when inspecting *View.swift or *App.swift files and reacting to keywords like NavigationStack, NavigationLink, and onOpenURL. The agent adheres to programmatic routing via NavigationPath and keeps independent navigation stacks inside each TabItem.

Deep linking rules require intercepting onOpenURL at the root view within WindowGroup, alongside Associated Domains configuration for applinks. The guide explicitly forbids force unwrapping URL components, mandates content checks before executing a route, and keeps the back stack consistent.

What it helps with

  • implement programmatic routing with NavigationStack and NavigationPath
  • handle incoming Universal Links safely via onOpenURL in root views
  • separate navigation stacks across multiple TabItem screens
  • prevent broken back stacks when parsing incoming URL parameters

Example prompts for the agent

  • Set up tab-based navigation where each TabItem maintains its own NavigationStack
  • Handle incoming Universal Links in App.swift using onOpenURL and guard let checks
  • Refactor our navigation flow to push destination items onto a shared NavigationPath

How to install ios-navigation

1Skills CLI (Vercel)

npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a claude-code

2Manually: put the files in place

~/.claude/skills/ios-navigation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ios-navigation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ios-navigation

How to install ios-navigation in Claude Code?

Run npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a claude-code in your terminal.

What does the ios-navigation skill do?

It enforces navigation standards for SwiftUI projects, covering NavigationStack routing, URL parsing safety, and deep link handling.

Which iOS version does this navigation guide target?

The instructions target iOS 16 and later to take advantage of native NavigationStack and NavigationPath APIs.

Source text

SKILL.md · MIT
---
name: ios-navigation
description: SwiftUI navigation and deep linking using NavigationStack and Universal Links. Use when implementing NavigationStack or Universal Links deep linking in iOS.
metadata:
  triggers:
    files:
    - '**/*View.swift'
    - '**/*App.swift'
    keywords:
    - NavigationStack
    - NavigationLink
    - onOpenURL
    - universalLink
    - NSUserActivity
---
# iOS Navigation (SwiftUI)

## **Priority: P2 (MEDIUM)**


## Guidelines

- **Stack**: Use `NavigationStack` (iOS 16+) with `NavigationPath` for programmatic control.
- **Deep Links**: Handle `onOpenURL` at Root View (`WindowGroup`).
- **Universal Links**: Configure Associated Domains (`applinks`) in Entitlements.
- **Tabs**: Maintain separate `NavigationStack` instances per `TabItem`.

See [NavigationStack and deep linking examples](references/swiftui-navigation.md)

## Anti-Patterns

- **No Force Unwrapping**: Use `guard let` when parsing URL components.
- **No Broken Back Stack**: Ensure valid path state before appending destinations.
- **No Missing Validation**: Check content availability before deep-link navigation.

## References

- [Navigation Patterns](references/swiftui-navigation.md)

© HoangNguyen0403 · MIT · HoangNguyen0403/agent-skills-standard

Similar skills

All skills for Mobile →

ios-navigation by other authors comes first.

ios-navigation pproenca ios-navigation enforces strict SwiftUI navigation rules for clinic modular MVVM-C apps in Swift 6.2. Helps structure coordinator flows, modal sheets, and deep links. CX Codex +1 275installs swiftui-patterns John Rogers (@johnrogers) swiftui-patterns guides Claude Code through iOS 17+ SwiftUI conventions: the @Observable macro, NavigationStack, and clean UIKit interop. CX Codex +1 ★ 233repo stars swiftui-navigation dpearson2699 Provides SwiftUI navigation architectures, covering typed stacks, multi-column layouts, sheets, and tabs. Useful when structuring navigation state across iOS and macOS apps. CX Codex +1 4,700installs mobile-ios-design Seth Hobson mobile-ios-design guides native iOS interface work with Apple HIG and SwiftUI patterns. Use it when building views, navigation, or adaptive layouts. CX Codex +1 23,659installs ios-hig-design wondelai ios-hig-design is a Claude Code skill for designing native iOS interfaces according to Apple's Human Interface Guidelines, covering safe areas, typography, color, navigation, and SF Symbols. CX Codex +1 9,200installs ios-accessibility dpearson2699 ios-accessibility guides accessibility reviews and code adjustments for Apple user interfaces. Helps configure screen reader flows, font scaling, and assistive focus states across devices. CX Codex +1 5,400installs ios-application-dev MiniMax-OpenSource ios-application-dev — a reference skill for iOS interfaces: UIKit, SnapKit and SwiftUI, with checklists for layout, Dynamic Type, Dark Mode and accessibility. CX Codex +1 2,200installs

Project sponsors

Companies that keep this analytics open