CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-navigation

Implement SwiftUI navigation patterns including NavigationStack, NavigationSplitView, sheet presentation, tab-based navigation, and deep linking. Use when building push navigation, programmatic routing, multi-column layouts, modal sheets, tab bars, universal links, or custom URL scheme handling.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable pattern reference: complete executable Swift examples for every navigation pattern, correct use of one-level-deep reference files, and a valuable Common Mistakes/Review Checklist pairing. The only weaknesses are a handful of over-explanations of concepts Claude already knows and workflows (notably router adoption) that are deferred to references without inline sequencing.

Suggestions

Trim explanations of widely-known behavior, e.g. replace 'Universal links let iOS open your app for standard HTTPS URLs' and 'Falls back to stack navigation on iPhone' with pure pattern guidance or delete them.

Inline the minimal router adoption steps (declare a @MainActor @Observable Router, inject via .environment(), route selection through a function) in the main body so the workflow is followable without opening references/navigationstack.md.

The 'Custom binding with side effects' paragraph names the technique but shows no code; add a short binding-with-interception example to match the actionability of the other sections.

DimensionReasoningScore

Conciseness

The body is largely lean pattern and version-gated API guidance (PresentationSizing values, iOS 26 Tab additions) that Claude cannot know reliably, but a few widely-known explanations could be trimmed, e.g. 'Universal links let iOS open your app for standard HTTPS URLs' and 'Falls back to stack navigation on iPhone'. This matches anchor 4 (efficient, minor instances of over-explanation) rather than 5, where every token would earn its place.

4 / 5

Actionability

Every major pattern ships complete, copy-paste-ready Swift code: typed Route enum with NavigationStack(path:), programmatic path manipulation, NavigationSplitView, manual HStack split with horizontalSizeClass, .sheet(item:) with .presentationSizing, TabView with the Tab(value:) API, and .onOpenURL app entry. Examples cover the common cases, matching anchor 5; not 4 because there are no meaningful gaps in executability.

5 / 5

Workflow Clarity

The deep-link section gives an explicit parse -> validate -> commit sequence with failure behavior ('Invalid links must leave the current navigation unchanged') and a Review Checklist is provided, but the body is primarily a pattern catalog: the router adoption workflow is deferred entirely to references/navigationstack.md with no inline steps. This fits anchor 4 (clear sequence, most checkpoints present, minor gaps) rather than 5, which would require fully explicit workflows with feedback loops throughout.

4 / 5

Progressive Disclosure

A clear overview with a table of contents, inline core patterns per topic, and well-signaled one-level-deep references ('See references/navigationstack.md for full router examples including per-tab stacks...'), plus a References section with descriptive labels. All five referenced files exist in references/ and none nest further references, matching anchor 5 exactly.

5 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states concrete capabilities in third person, provides an explicit 'Use when' clause with seven natural trigger phrases including synonyms, and is tightly scoped to SwiftUI navigation so conflict risk with sibling skills is minimal. Both the what and when questions are answered explicitly and concretely.

DimensionReasoningScore

Specificity

'Implement SwiftUI navigation patterns including NavigationStack, NavigationSplitView, sheet presentation, tab-based navigation, and deep linking' names five concrete capabilities that comprehensively cover the navigation domain. This matches anchor 5 (multiple specific concrete actions, comprehensive coverage) rather than 4, since no meaningful capability area is missing.

5 / 5

Completeness

It explicitly answers both questions: what ('Implement SwiftUI navigation patterns including...') and when ('Use when building push navigation, programmatic routing, ... universal links, or custom URL scheme handling') with concrete trigger phrases. This is a direct match to the anchor 5 exemplar structure.

5 / 5

Trigger Term Quality

The when-clause lists seven natural trigger phrases ('push navigation, programmatic routing, multi-column layouts, modal sheets, tab bars, universal links, or custom URL scheme handling') and the what-clause adds the API names users actually type (NavigationStack, NavigationSplitView), with synonyms covered (sheet presentation/modal sheets, tab-based navigation/tab bars, deep linking/universal links/URL scheme). This matches anchor 5's comprehensive synonym coverage; anchor 4 ('a few natural terms missing') would apply only if common phrasings like these were absent.

5 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to SwiftUI navigation, and its triggers (NavigationStack, universal links, custom URL schemes, tab bars, modal sheets) are unambiguous navigation requests no sibling skill would claim. Clear niche with distinct triggers and minimal conflict risk matches anchor 5; anchor 4's 'minor overlap risk' would require shared trigger territory, which at most 'multi-column layouts' brushes against.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

thienqo/ios-skills

Path

skills/swiftui-navigation/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.