widgetkit

Guide WidgetKit implementation and troubleshooting for timelines and widget updates.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill widgetkit-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: widgetkit
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/apple-skills/skills/widgetkit
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill widgetkit-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you quickly find correct answers about WidgetKit APIs and concepts so you can implement widgets without guessing how timelines, entries, and providers should work.

Core Features & Use Cases

  • WidgetKit API lookup: Finds guidance for core protocols and types like TimelineProvider, TimelineEntry, and WidgetCenter.
  • Timeline & relevance understanding: Clarifies how snapshots, timelines, refresh policies, and relevance clues affect updates.
  • Widget structure reference: Supports building widget extensions, configuring widget families, and understanding widget creation patterns.
  • Use case: When your widget shows stale data, use this Skill to determine the right timeline strategy (snapshot vs timeline, refresh policy, and reload triggers) for your update needs.

Quick Start

Ask the AI: “Using WidgetKit, how should I implement a TimelineProvider that updates a widget efficiently with the right refresh policy and relevance strategy?”

Frequently Asked Questions about widgetkit

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

FAQPage Schema
How do I implement a TimelineProvider to update WidgetKit entries efficiently?

To implement a TimelineProvider for WidgetKit entries, you configure the provider to generate snapshots or timelines with specific refresh policies and relevance clues. This Skill guides you through the correct timeline strategy and reload timing for your update needs.

Why does my WidgetKit widget show stale data and not refresh on schedule?

If your WidgetKit widget shows stale data, the timeline strategy likely needs adjusting. This Skill helps you determine the right refresh policy, snapshot versus timeline generation, and reload triggers like WidgetCenter to ensure timely updates.

What is the difference between a snapshot and a timeline in WidgetKit?

In WidgetKit, a snapshot provides a single immediate entry, while a timeline supplies a sequence of future entries. This Skill clarifies how both mechanisms work alongside relevance clues to control your widget update frequency.

How do I configure widget families and system contexts in a widget extension?

To configure widget families and system contexts in a widget extension, you structure your widget creation patterns to support different sizes. This Skill provides reference guidance on widget configuration and structure across various contexts.

When should I use WidgetCenter to trigger widget reloads?

You should use WidgetCenter to trigger widget reloads when underlying data changes outside the scheduled timeline. This Skill helps determine the appropriate reload triggers and timeline strategies to keep your widget data current.

Does WidgetKit support custom relevance clues for prioritizing timeline entries?

Yes, WidgetKit supports custom relevance clues for prioritizing timeline entries. This Skill helps you understand how relevance clues affect update timing and how to implement them alongside your chosen refresh policies.