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
npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/ios-navigation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ios-navigation/
1Skills CLI (Vercel)
npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a codex2Manually: put the files in place
.agents/skills/ios-navigation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a cursor2Manually: put the files in place
.cursor/skills/ios-navigation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HoangNguyen0403/agent-skills-standard skills/ios/ios-navigation2Manually: put the files in place
.github/skills/ios-navigation/SKILL.md1Skills CLI (Vercel)
npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a gemini-cli2Platform CLI
gemini skills install https://github.com/HoangNguyen0403/agent-skills-standard --path skills/ios/ios-navigationManually: put the files in place
.devin/skills/ios-navigation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HoangNguyen0403/agent-skills-standard --skill ios-navigation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.