relevancekitlisted
Install: claude install-skill dpearson2699/swift-ios-skills
# RelevanceKit
Provide on-device contextual clues that increase a widget's visibility in the
Smart Stack on Apple Watch. RelevanceKit tells the system *when* a widget is
relevant -- by time, location, fitness state, sleep schedule, or connected
hardware -- so the Smart Stack can surface the right widget at the right moment.
Targets Swift 6.3 / watchOS 26+.
> **Beta-sensitive.** RelevanceKit shipped with watchOS 26. Re-check Apple
> documentation before making strong claims about API availability or behavior.
See [references/relevancekit-patterns.md](references/relevancekit-patterns.md) for complete code patterns including
relevant widgets, timeline provider integration, grouping, previews, and
permission handling.
## Contents
- [Overview](#overview)
- [Setup](#setup)
- [Relevance Providers](#relevance-providers)
- [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 Stack:
1. **Timeline provider relevance** -- implement `relevance()` on an existing
`AppIntentTimelineProvider` to attach `RelevantContext` clues to timeline
entries. Available