Agent skill · software engineering · dpearson2699
tipkit
Implement and review Apple TipKit feature-discovery UI for iOS 17+ apps. Use when adding or auditing in-app tips, contextual help, coach marks, Tip, TipView, popoverTip, rules, events, actions, display frequency, testing overrides, reusable tip identifiers, or iOS 18+ TipGroup and CloudKit tip sync; avoid for generic SwiftUI navigation or layout outside tip presentation.
Why this skill is useful
Provides specific implementation patterns and configuration examples for using TipKit in iOS apps, which the AI wouldn't reliably generate on its own.
What it needs
Requires xcode installed locally. About 7k tokens when loaded. Last updated 2026-07-31. 973 stars on the source repository.
What this skill does
TipKit Use TipKit for small, contextual feature-discovery moments: inline tips, popover tips, rule-gated education, and lightweight coach marks. Keep generic SwiftUI architecture, navigation, layout, and long first-run onboarding flows in their sibling skills unless TipKit presentation is the core issue. Contents Availability Configure TipKit Design Good Tips Define Tips Present Tips Rules and Events Options and Invalidation Actions and Styles Tip Groups Testing Common Mistakes Review Checklist References Availability TipKit's core Tip, TipView, popoverTip, rules, events, options, and testing overrides are available on iOS 17+, iPadOS 17+, macOS 14+, tvOS 17+, watchOS 10+, and visionOS 1+. Gate newer APIs explicitly: API Availability Use --- --- --- TipGroup iOS 18+ Group or sequence tips; apply the Tip Groups decision. .cloudKitContainer(...) iOS 18+ Sync tip state, parameters, events, and display counts across devices. MaxDisplayDuration iOS 18+ Automatically invalidate after cumulative display time. resetEligibility() iOS 26+ Make a previously invalidated tip eligible again without resetting the datastore. Configure TipKit Call Tips.configure(:) once during app initialization, before any tip can display. Do not configure TipKit from a view's onAppear or .task. Use .datastoreLocation(.groupContainer(identifier:)) only when an app and extension or app-group members intentionally share tip state. Keep option settings consistent across app-group members because TipKit persists option state with the tip record. CloudKit Sync Use CloudKit sync only on iOS 18+ and later. Enable iCloud + CloudKit and Background Modes > Remote notifications, then pass a container: Prefer a dedicated container with a .tips suffix. .automatic uses the first entitled .tips container when present, then falls back to the primary container. Design Good Tips Tips are small, transient help. Use them for features people can understand and try in a few simple steps. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills dpearson2699/tipkit