WidgetKit — Foundations Skill

Purpose

Route WidgetKit implementation tasks to the minimum required WidgetKit Knowledge Contracts. v1 scope is home-screen and Lock-Screen widgets built with Widget/WidgetConfiguration and TimelineProvider only — no Live Activities, no watchOS complications as a distinct surface, no Control Widgets, no StandBy-specific layout.

Routing

Load only the contracts relevant to the task. All paths relative to knowledge/widgetkit/.

• Conforming to Widget, WidgetBundle, or WidgetConfiguration; choosing StaticConfiguration/AppIntentConfiguration; declaring supportedFamilies or reading @Environment(\.widgetFamily); applying .containerBackground(for: .widget); or the kind string's stability -> widget-declaration-and-families.md
• Implementing TimelineProvider's placeholder(in:), getSnapshot(in:completion:), or getTimeline(in:completion:); building a Timeline of TimelineEntry values; or choosing a TimelineReloadPolicy -> timeline-provider-and-entries.md
• Wiring widgetURL(_:), Link, Button(intent:), or Toggle(_:isOn:intent:) into a widget's view -> widget-interactivity-and-deep-links.md
• Calling WidgetCenter.shared.reloadTimelines(ofKind:)/reloadAllTimelines(), or reasoning about the refresh budget -> timeline-reloading-and-refresh-budget.md

Never load more than the contracts relevant to the specific question.

Stop Conditions

Stop and report if the requested topic has no matching Knowledge Contract in knowledge/widgetkit/ — do not guess or fall back to general knowledge.

• Live Activities and ActivityKit — Deferred
• watchOS complications as a distinct surface — Deferred
• Control Widgets (iOS 18 Controls/ControlWidget) — Deferred
• StandBy-specific layout — Deferred
• Authoring an AppIntent itself — its parameters, perform() body, and any entities it exposes — owned by app-intents (knowledge.app-intents.intent-results-and-widget-hookup); this Skill only routes to wiring an already-authored intent into a widget's tap target
• Scheduling the background work that produces new widget data (e.g. a BGAppRefreshTask) — owned by backgroundtasks (knowledge.backgroundtasks.background-refresh-and-widget-timeline-hookup); this Skill only routes to the reloadTimelines/reloadAllTimelines call site once new data has already landed