skills.rest
Roy-wonji
Roy-wonjiCOMMUNITY
Explore all skills by this author →
GitHub

relevancekit

Configure watchOS widget Smart Stack visibility with contextual relevance signals.

Updated May 6, 2026
Search Tags:#permissions#widgetkit#watchos#relevancekit#smart stack#relevance configuration#contextual signals
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill relevancekit-roy-wonji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: relevancekit
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/swift-ios-skills/skills/relevancekit
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill relevancekit-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

RelevanceKit helps your watchOS widgets become more visible in the Smart Stack by expressing exactly when and why each widget should be relevant instead of relying on generic timelines.

Core Features & Use Cases

  • Time-based relevance: Declare relevance for a specific moment or time range (including “scheduled” vs “informational” hints) so Smart Stack surfaces cards when they matter.
  • Location, fitness, and sleep relevance: Use contextual clues (inferred or region-based location, HealthKit workout/activity, and sleep schedule) to make widgets appear during real-life routines.
  • Hardware relevance and signal combining: Trigger visibility using connected hardware signals (e.g., headphones) and combine multiple relevance attributes ordered by priority.
  • Widget integration patterns: Support both the timeline-provider relevance path and the watchOS 26+ RelevanceConfiguration/RelevanceEntriesProvider path, including grouping and associated timeline kind to avoid duplicates.

Quick Start

Use relevancekit to configure your watchOS 26+ widget’s Smart Stack visibility by defining a RelevanceEntriesProvider or adding a relevance() method to an existing AppIntentTimelineProvider with the right RelevantContext clues for your widget.

Frequently Asked Questions about relevancekit

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

FAQPage Schema
How do I make a watchOS widget appear in the Smart Stack at specific times?▼

You make a watchOS widget appear in the Smart Stack by attaching time-based contextual relevance signals using RelevantContext, declaring specific moments or time ranges when the widget should surface instead of relying on generic timelines.

Can I trigger widget visibility in Smart Stack based on location and fitness state?▼

Yes, you can trigger widget visibility in Smart Stack based on location and fitness state by using contextual clues like inferred or region-based location, HealthKit workout activity, and sleep schedules to make widgets appear during real-life routines.

What is the best way to combine multiple relevance signals for a single watchOS widget?▼

The best way to combine multiple relevance signals for a single watchOS widget is to provide ordered relevance attributes, combining contextual clues like connected hardware and time windows prioritized by importance to control Smart Stack visibility.

Does configuring Smart Stack relevance require RelevanceEntriesProvider on watchOS 26+?▼

Yes, configuring Smart Stack relevance on watchOS 26+ requires using the RelevanceEntriesProvider path or adding a relevance method to an AppIntentTimelineProvider, including proper permissions handling in both app and widget extension targets.

How do I prevent duplicate widgets from appearing in the Smart Stack?▼

You prevent duplicate widgets from appearing in the Smart Stack by using RelevanceConfiguration with proper grouping and associated timeline kind, ensuring ordered relevance attributes avoid overlapping visibility conditions.

Related Skills

Explore More Software Engineering Skills→
hashintelhashintel
1.6k

handling-rust-errors

Apply error-stack patterns to standardize Rust error handling with contextual propagation.

Official
Intermediate
FelixRauchFelixRauch

relevancekit

Attach contextual relevance signals to watchOS Smart Stack widgets.

Community
Intermediate
onymchatonymchat

relevancekit

Integrate RelevanceKit with WidgetKit to surface watchOS 26+ widgets using on-device relevance clues.

Official
Advanced
yashpalsince2004yashpalsince2004

relevancekit

Create contextual relevance signals for Apple Watch widgets using RelevanceKit and WidgetKit.

Community
Advanced