relevancekit

Provide on-device watchOS relevance hints for Smart Stack widgets.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/harshav167/build-ios-apps --skill relevancekit-harshav167
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: relevancekit
Source: https://github.com/harshav167/build-ios-apps/tree/main/skills/relevancekit
Command: npx skills add https://github.com/harshav167/build-ios-apps --skill relevancekit-harshav167

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Widgets often appear in the Smart Stack even when they aren't relevant. RelevanceKit provides on-device relevance clues to surface only the right watchOS widgets at the right time.

Core Features & Use Cases

  • On-device relevance cues (time, location, fitness, sleep, hardware) drive which widgets are shown.
  • RelevanceEntriesProvider-based widgets support relevance() + entry(configuration:context:)/placeholder(context:) patterns.
  • Grouping, associatedKind, and permission guidance help avoid duplicate cards and ensure graceful degradation when permissions are missing.

Quick Start

Create a watchOS 26 RelevanceKit widget that uses a RelevanceEntriesProvider and relevance() to surface a single card only when relevant

Frequently Asked Questions about relevancekit

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

FAQPage Schema
How do I surface relevant watchOS widgets in Smart Stack only when specific conditions are met?

To surface relevant watchOS widgets in Smart Stack, use a RelevanceEntriesProvider with a relevance() method that supplies on-device clues like time, location, fitness, sleep, and hardware signals. This ensures widgets appear only when those specific conditions are met.

What signals can I use for watchOS widget relevance attributes?

WatchOS widget relevance attributes support time-based, location-based, fitness, sleep, and hardware signals. You group these ordered WidgetRelevanceAttribute clues to provide on-device hints that determine exactly when a widget card should appear.

How do I handle placeholders and previews for RelevanceEntriesProvider widgets?

Handling placeholders and previews for RelevanceEntriesProvider widgets requires implementing the placeholder(context:) method alongside entry(configuration:context:). This pattern ensures your widget displays correctly in preview contexts before actual relevance conditions are evaluated.

Does RelevanceKit require watchOS 26 for Smart Stack relevance hints?

Yes, RelevanceKit requires watchOS 26 availability to implement Smart Stack relevance hints. This version provides the necessary RelevanceEntriesProvider API and WidgetRelevance structures for delivering on-device widget relevance clues.

How do I avoid duplicate widget cards in the Smart Stack?

To avoid duplicate widget cards in the Smart Stack, use grouping and associatedKind properties within your RelevanceEntriesProvider implementation. This configuration prevents multiple identical widget instances from surfacing simultaneously.

What is the best way to manage widget relevance when permissions are missing?

The best way to manage widget relevance when permissions are missing is to follow permission guidance for graceful degradation. Your RelevanceEntriesProvider should handle missing location or fitness permissions by falling back to available relevance attributes without crashing.