swiftui-navigation — Claude Code skill: what it does, how to install
Provides SwiftUI navigation architectures, covering typed stacks, multi-column layouts, sheets, and tabs. Useful when structuring navigation state across iOS and macOS apps.
npx skills add dpearson2699/swift-ios-skills --skill swiftui-navigation -a claude-codeWhat swiftui-navigation does
This skill guides the agent to implement programmatic navigation using NavigationStack bound to a typed [Route] array. Routes rely on a Hashable enum mapped with .navigationDestination(for:), guaranteeing compile-time safety. To avoid cluttered views, an app router object holds stack and modal state, injected across subviews using SwiftUI environment modifiers.
For split layouts on iPad and Mac, it provides standard NavigationSplitView setups and manual HStack splits conditioned on horizontalSizeClass. Sheet presentations prioritize .sheet(item:) over boolean flags, combining them with .presentationSizing controls and .interactiveDismissDisabled to protect unsaved form edits.
The guidelines target iOS 26+ with Swift 6.3, remaining compatible down to iOS 17. Projects locked to earlier OS releases cannot use these patterns because they drop legacy NavigationView entirely.
What it helps with
- build type-safe programmatic navigation using a route enum
- isolate navigation stacks inside separate tab items
- implement multi-column interfaces with NavigationSplitView
- guard unsaved sheet changes against accidental interactive dismissal
Example prompts for the agent
- Set up a router-based NavigationStack using a custom route enum
- Create a multi-column layout using NavigationSplitView for iPad
- Configure a sheet presentation with custom presentationSizing
How to install swiftui-navigation
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swiftui-navigation -a claude-code2Manually: put the files in place
~/.claude/skills/swiftui-navigation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/swiftui-navigation/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swiftui-navigation -a codex2Manually: put the files in place
.agents/skills/swiftui-navigation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swiftui-navigation -a cursor2Manually: put the files in place
.cursor/skills/swiftui-navigation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills swiftui-navigation2Manually: put the files in place
.github/skills/swiftui-navigation/SKILL.md1Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swiftui-navigation -a gemini-cli2Platform CLI
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/swiftui-navigationManually: put the files in place
.devin/skills/swiftui-navigation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill swiftui-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 swiftui-navigation
How to install swiftui-navigation in Claude Code?
Run npx skills add dpearson2699/swift-ios-skills --skill swiftui-navigation -a claude-code in your terminal. You can also save the file directly to ~/.claude/skills/swiftui-navigation/SKILL.md.
What does swiftui-navigation do?
It defines structural patterns for SwiftUI routing, including programmatic stacks, split view columns, sheets, and tab navigation.
Which iOS versions does swiftui-navigation require?
Patterns target iOS 26+ with Swift 6.3, offering backward compatibility to iOS 17. Features like .presentationSizing specifically require iOS 18+.