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.
npx skills add dpearson2699/swift-ios-skills --skill relevancekit --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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](references/relevancekit-patterns.md) for complete relevant-widget, timeline provider, grouping, preview, and permission patterns. ## Contents - [Overview](#overview) - [Setup](#setup) - [Relevance Providers](#relevance-providers) - [Boundary Routing](#boundary-routing) - [Time-Based Relevance](#time-based-relevance) - [Location-Based Relevance](#location-based-relevance) - [Fitness and Sleep Relevance](#fitness-and-sleep-relevance) - [Hardware Relevance](#hardware-relevance) - [Combining Signals](#combining-signals) - [Widget Integration](#widget-integration) - [Common Mistakes](#common-mistakes) - [Review Checklist](#review-checklist) - [References](#references) ## Overview watchOS uses two mechanisms to determine widget relevance in the Smart Sta
- Contents
- Overview
- Key Types
- Setup
- Import
- Platform Availability
- Permissions
- Relevance Providers
- Option 1: Timeline Provider with Relevance
- Option 2: RelevanceEntriesProvider (watchOS 26+)
- Boundary Routing
- Time-Based Relevance
- Single Date
- Date with Kind
What does the relevancekit skill do?
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.
How do I install it?
Run `npx skills add dpearson2699/swift-ios-skills --skill relevancekit --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From dpearson2699/swift-ios-skills, a repository with 963 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.