Agent skill · software engineering · dpearson2699
relevancekit
Increase widget visibility on Apple Watch using RelevanceKit. Use when providing contextual relevance signals for watchOS widgets, declaring time-based or location-based relevance, combining multiple relevance providers, helping the system surface the right widget at the right time on watchOS 26, or routing mixed RelevanceKit/WidgetKit/HealthKit/MapKit Smart Stack scope.
Why this skill is useful
Provides specific implementation patterns and APIs for enhancing widget visibility on watchOS using RelevanceKit that the AI wouldn't reliably generate on its own.
What it needs
About 7k tokens when loaded. Last updated 2026-07-31. 973 stars on the source repository.
What this skill does
RelevanceKit Provide on-device contextual clues that increase a widget's visibility in the Apple Watch Smart Stack. RelevanceKit tells the system when a widget is relevant by time, location, fitness state, sleep schedule, or connected hardware. Targets Swift 6.3 / watchOS 26+. Beta-sensitive. Re-check Apple documentation before making strong RelevanceKit availability or behavior claims. See references/relevancekit-patterns.md for complete relevant-widget, timeline provider, grouping, preview, and permission patterns. Contents Overview Setup Relevance Providers Boundary Routing Time-Based Relevance Location-Based Relevance Fitness and Sleep Relevance Hardware Relevance Combining Signals Widget Integration Common Mistakes Review Checklist References Overview watchOS uses two mechanisms to determine widget relevance in the Smart Stack: 1. Timeline provider relevance -- implement relevance() on an existing AppIntentTimelineProvider to attach RelevantContext clues to timeline entries. Available across platforms; only watchOS acts on the data. 2. Relevant widget -- use RelevanceConfiguration with a RelevanceEntriesProvider to build a widget driven entirely by relevance clues. The system creates individual Smart Stack cards per relevant entry. watchOS 26+ only. Choose a timeline provider when the widget always has data to show and relevance is supplementary. Choose a relevant widget when the widget should only appear when conditions match, or when multiple cards should appear simultaneously (e.g., several upcoming calendar events). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills dpearson2699/relevancekit