relevancekit

Configure watchOS 26+ widgets with contextual relevance cues from time, location, fitness, sleep, and hardware signals.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/femitz/flyby --skill relevancekit-femitz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: relevancekit
Source: https://github.com/femitz/flyby/tree/main/.agents/skills/relevancekit
Command: npx skills add https://github.com/femitz/flyby --skill relevancekit-femitz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

RelevanceKit helps developers increase the visibility of Apple Watch widgets by providing on-device contextual clues that influence Smart Stack presentation, surfacing the most relevant cards at the right moments.

Core Features & Use Cases

  • Time-based relevance through RelevantContext.date and timeline integration
  • Location, fitness, sleep, and hardware signals to adjust widget visibility and grouping
  • watchOS 26+ support with RelevanceEntriesProvider and RelevanceConfiguration
  • Guidance on permissions, grouping, previews, and cross-component integration to ensure graceful degradation

Quick Start

Add a RelevanceEntriesProvider and a RelevanceConfiguration to your watchOS widget and deploy to test in the simulator.

Frequently Asked Questions about relevancekit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make Apple Watch widgets appear in the Smart Stack at the right moment?

You surface Apple Watch widgets contextually by providing on-device relevance cues that influence Smart Stack presentation, surfacing the most relevant cards at the right moments using time, location, fitness, sleep, and hardware signals.

What signals can I use to determine widget visibility on watchOS?

You can determine widget visibility on watchOS using time, location, fitness, sleep, and hardware signals. These contextual cues adjust when your widgets appear and how they are grouped together.

How do I configure widget contextual relevance using RelevanceKit and WidgetKit?

To configure contextual relevance, add a RelevanceEntriesProvider and a RelevanceConfiguration to your watchOS widget. You then integrate RelevantContext.date and timeline data to control visibility and grouping.

Does RelevanceKit require a specific watchOS version to surface widgets?

Yes, surfacing widgets with RelevanceKit requires watchOS 26 or later. It uses watchOS 26+ support with RelevanceEntriesProvider and RelevanceConfiguration to determine widget visibility and grouping.

How do I handle permissions and previewing when adding contextual signals to widgets?

When adding contextual signals, you follow guidance on permissions to request access to location and fitness data, and use previewing to test widget visibility and grouping before deploying to the simulator.

What happens to Smart Stack widgets when contextual relevance signals are unavailable?

When contextual relevance signals are unavailable, cross-component integration ensures graceful degradation. This prevents widgets from surfacing improperly when time, location, or hardware data is missing.