
Relevancekit
Generate watchOS 26 Smart Stack snippets that show one relevant meeting card using RelevanceKit APIs and correct availability annotations.
Overview
Relevancekit is an agent skill for the Build phase that produces watchOS 26 RelevanceKit Smart Stack widget plans with providers, entries, relevance attributes, and preview handling.
Install
npx skills add https://github.com/dpearson2699/swift-ios-skills --skill relevancekitWhat is this skill?
- Uses RelevanceConfiguration with RelevanceEntriesProvider instead of timeline-only widgets for one-card-per-meeting Smar
- Defines RelevanceEntry with relevance(), entry(configuration:context:), and placeholder(context:) provider methods.
- Requires @available(watchOS 26.0, *) (or equivalent) on watchOS 26+ only types and targets.
- Returns WidgetRelevance with priority-ordered WidgetRelevanceAttribute values.
- Handles context.isPreview in entry(configuration:context:) with representative preview data.
- Eval assertions expect six RelevanceKit-specific implementation checks including preview and associatedKind handling.
Adoption & trust: 1.2k installs on skills.sh; 713 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need a watchOS 26 Smart Stack widget that shows one meeting card at a time with correct RelevanceKit APIs, not a miswired timeline-only configuration.
Who is it for?
Solo Swift developers targeting watchOS 26 who want agent-generated RelevanceKit structure for calendar or meeting widgets.
Skip if: Teams building only iPhone timeline widgets on older OS versions without RelevanceKit—use standard WidgetKit skills instead.
When should I use this skill?
You are implementing a watchOS 26 Smart Stack relevant widget that shows one upcoming meeting card with RelevanceKit providers and priority-ordered relevance.
What do I get? / Deliverables
You get an implementation plan with RelevanceConfiguration, RelevanceEntriesProvider, RelevanceEntry, WidgetRelevance ordering, preview handling, and associated-kind guidance ready to paste into a watchOS 26+ target.
- RelevanceKit widget implementation plan with provider and entry types
- Preview and placeholder handling snippets with availability annotations
Recommended Skills
Journey fit
Build is where watchOS widget targets, SwiftUI configuration, and platform SDK work happen for shipping a wearable experience. Frontend subphase covers SwiftUI widget surfaces, previews, and client-side relevance ordering rather than backend APIs.
How it compares
Skill package for RelevanceKit widget scaffolding, not a hosted calendar API or App Store metadata generator.
Common Questions / FAQ
Who is relevancekit for?
It is for indie watchOS and SwiftUI builders implementing Smart Stack relevant widgets with watchOS 26 RelevanceKit APIs.
When should I use relevancekit?
Use it during Build when you are defining RelevanceConfiguration, entry shapes, relevance priorities, and preview behavior for one-card-per-meeting widgets.
Is relevancekit safe to install?
It is a code-generation skill; review generated Swift on this page’s Security Audits panel and in Xcode before shipping widgets that read calendar data.
SKILL.md
READMESKILL.md - Relevancekit
{ "skill_name": "relevancekit", "evals": [ { "id": 0, "prompt": "Build focused Swift snippets for a watchOS 26 Smart Stack widget that shows one card per upcoming meeting only when each meeting is relevant. Include the relevance provider, entry shape, widget configuration, preview handling, grouping or associated-kind guidance, and the availability annotations that matter.", "expected_output": "A RelevanceKit relevant-widget implementation plan that uses RelevanceConfiguration, RelevanceEntriesProvider, RelevanceEntry, WidgetRelevance, and RelevantContext.date with watchOS 26.0 availability, preview/placeholder handling, and priority-ordered relevance attributes.", "files": [], "assertions": [ "Uses `RelevanceConfiguration` with a `RelevanceEntriesProvider` instead of a normal timeline-only widget for one-card-per-meeting Smart Stack behavior.", "Defines a `RelevanceEntry` and a provider with `relevance()`, `entry(configuration:context:)`, and `placeholder(context:)`.", "Annotates relevant-widget-only types or snippets with `@available(watchOS 26.0, *)` or otherwise states they live in a watchOS 26+ target.", "Returns `WidgetRelevance` with `WidgetRelevanceAttribute` values ordered by priority.", "Handles `context.isPreview` in `entry(configuration:context:)` and returns representative preview data.", "Uses `.associatedKind(_:)` when the relevant widget overlaps with an existing timeline widget, or explains when grouping should be used instead." ] }, { "id": 1, "prompt": "Review this RelevanceKit plan: add `NSLocationWhenInUseUsageDescription` to the widget extension, request one broad HealthKit permission, create `RelevantContext.location(category: .cafe)!`, use `.fitness(.activityRingsIncomplete)`, and assume it will improve an iPhone Smart Stack too. Fix the plan.", "expected_output": "A correction-focused RelevanceKit review that separates app and widget location setup, handles optional point-of-interest relevance, maps fitness clues to exact HealthKit types, and states the watchOS-only effect of RelevanceKit clues.", "files": [], "assertions": [ "Places location purpose strings and the location authorization request in the containing app while adding `NSWidgetWantsLocation` to the widget extension.", "Checks `CLLocationManager.isAuthorizedForWidgetUpdates` before relying on widget location clues.", "Handles the optional result from `RelevantContext.location(category:)` instead of force-unwrapping it.", "Maps `.fitness(.activityRingsIncomplete)` to `appleExerciseTime`, `appleMoveTime`, and `appleStandTime` HealthKit read types.", "Mentions `HKWorkoutType` as the HealthKit type needed for `.fitness(.workoutActive)` if active-workout relevance is used.", "States that RelevanceKit clues only affect Smart Stack behavior on watchOS even though some APIs compile on other platforms." ] }, { "id": 2, "prompt": "A team wants a single answer covering an iOS Home Screen widget timeline, watchOS Smart Stack relevance, HealthKit workout recording, MapKit place search, and APNs widget push updates. Explain what belongs in RelevanceKit and what should be routed to sibling Apple framework skills.", "expected_output": "A boundary-aware routing memo that keeps RelevanceKit focused on watchOS Smart Stack relevance clues and relevant widgets, while routing general WidgetKit timelines/push updates, HealthKit workout recording, and MapKit place search to sibling skills.", "files": [], "assertions": [ "Keeps RelevanceKit scope to watchOS Smart Stack relevance clues, `RelevantContext`, timeline-provider `relevance()`, `RelevantIntentManager`, `RelevanceConfiguration`, and relevant-widget entries.", "Routes general iOS Home Screen widget timelines, refresh budgets, widget families, controls, Live Activities, and A