widgetkit-code-review — скилл для Claude Code: ревью кода WidgetKit
Скилл widgetkit-code-review проверяет код виджетов на WidgetKit по чек-листу: таймлайн, вёрстка, настраиваемые интенты, память. Пригодится перед релизом виджета и после переезда на iOS 17.
Apache-2.0 121 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill widgetkit-code-review -a claude-codeЧто делает widgetkit-code-review
Скилл прогоняет код виджета по чек-листу WidgetKit. Смотрит, что placeholder(in:) отдаёт результат сразу, без асинхронной работы, записи таймлайна стоят с шагом не меньше 5 минут, getSnapshot учитывает context.isPreview, в systemSmall стоит widgetURL, а не Link. Отдельно ищет то, чего в виджетах быть не должно: Button, AsyncImage, UIViewRepresentable.
Под чек-листом лежат четыре справочника: references/timeline.md, references/views.md, references/intents.md, references/performance.md. Скилл открывает тот, что совпадает с проблемой: таймлайн, Lock Screen, конфигурируемые интенты, память. Попутно спрашивает про кэш через App Groups и про то, что будет со старыми виджетами после смены параметров интента.
Каждая находка несёт метку [FILE:LINE], снятую с текущего файла, а перед отчётом проверяющий читает TimelineProvider или конфиг виджета целиком, не диф. Утверждения про бюджет обновлений, память (~30 МБ), App Groups или миграцию с IntentConfiguration требуют названного артефакта: .entitlements, IPHONEOS_DEPLOYMENT_TARGET, обработки WidgetFamily. Не назвал — находка уходит в открытые вопросы. Итог простой: нет локации, нет находки в отчёте.
Какие задачи решает
- проверить
placeholder(in:)на лишнюю асинхронную работу - разобрать таймлайн и политику перезагрузки
- перевести вьюхи на
containerBackground(for:) - уложить картинки в лимит памяти виджета (~30 МБ)
- оценить риск миграции с
IntentConfigurationнаAppIntentConfiguration
Примеры запросов агенту
- Отревьюи модуль виджета в
Sources/WeatherWidgetпо чек-листу WidgetKit, каждое замечание пометь[FILE:LINE]. - Проверь
TimelineProviderвTimeline.swift: есть ли будущие записи или мы надеемся на частые обновления? - Глянь конфигурируемый виджет: что сломается у существующих пользователей после смены параметров интента?
Как установить widgetkit-code-review
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill widgetkit-code-review -a claude-code2Вручную: положить файлы
~/.claude/skills/widgetkit-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/widgetkit-code-review/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill widgetkit-code-review -a codex2Вручную: положить файлы
.agents/skills/widgetkit-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill widgetkit-code-review -a cursor2Вручную: положить файлы
.cursor/skills/widgetkit-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-ios/skills/widgetkit-code-review2Вручную: положить файлы
.github/skills/widgetkit-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill widgetkit-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-ios/skills/widgetkit-code-reviewВручную: положить файлы
.devin/skills/widgetkit-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill widgetkit-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о widgetkit-code-review
Как установить widgetkit-code-review в Claude Code?
Выполните npx skills add existential-birds/beagle --skill widgetkit-code-review -a claude-code. Скилл окажется в ~/.claude/skills/widgetkit-code-review/SKILL.md.
Что делает widgetkit-code-review?
Идёт по коду виджета с чек-листом WidgetKit: таймлайн, вёрстка, конфигурируемые интенты, память. По ходу дела подтягивает нужный справочник из references/.
Когда находка не попадает в отчёт?
Если у неё нет [FILE:LINE] из текущего файла или проверяющий не прочитал TimelineProvider целиком. Претензии к бюджету обновлений, памяти или App Groups без названного артефакта становятся открытым вопросом.
Исходный текст
SKILL.md · Apache-2.0
--- name: widgetkit-code-review description: Reviews WidgetKit code for timeline management, view composition, configurable intents, and performance. Use when reviewing code with import WidgetKit, TimelineProvider, Widget protocol, or @main struct Widget. --- # WidgetKit Code Review ## Quick Reference | Issue Type | Reference | |------------|-----------| | TimelineProvider, entries, reload policies | [references/timeline.md](references/timeline.md) | | Widget families, containerBackground, deep linking | [references/views.md](references/views.md) | | AppIntentConfiguration, EntityQuery, @Parameter | [references/intents.md](references/intents.md) | | Refresh budget, memory limits, caching | [references/performance.md](references/performance.md) | ## Review Checklist - [ ] `placeholder(in:)` returns immediately without async work - [ ] Timeline entries spaced at least 5 minutes apart - [ ] `getSnapshot` checks `context.isPreview` for gallery previews - [ ] `containerBackground(for:)` used for iOS 17+ compatibility - [ ] `widgetURL` used for systemSmall (not Link) - [ ] No Button views (use Link or widgetURL) - [ ] No AsyncImage or UIViewRepresentable in widget views - [ ] Images downsampled to widget display size (~30MB limit) - [ ] App Groups configured for data sharing between app and widget - [ ] EntityQuery implements `defaultResult()` for non-optional parameters - [ ] New intent parameters handle nil for existing widgets after updates - [ ] `reloadTimelines` called strategically (not on every data change) ## When to Load References - TimelineProvider implementation or refresh issues -> timeline.md - Widget sizes, Lock Screen, containerBackground -> views.md - Configurable widgets, AppIntent migration -> intents.md - Memory issues, caching, budget management -> performance.md ## Review Questions 1. Does the widget provide fallback entries for when system delays refresh? 2. Are Lock Screen families (accessoryCircular/Rectangular/Inline) handled appropriately? 3. Would migrating from IntentConfiguration break existing user widgets? 4. Is timeline populated with future entries or does it rely on frequent refreshes? 5. Is data cached via App Groups for widget access? ## Hard gates (before reporting) Complete **in order** for each finding you intend to report. Do not advance until the pass condition is satisfied. 1. **Location artifact** — The finding includes `[FILE:LINE]` (or a line range) copied from the current file contents; the path resolves in this repo. 2. **Scope read** — You read the full surrounding implementation: the `TimelineProvider` (including `placeholder`, `getSnapshot`, and `getTimeline` when relevant), the `@main` `Widget` / widget bundle, or the configurable widget’s `AppIntentConfiguration` / intent types—not only a diff hunk or snippet. 3. **Platform or system claim** (only if the finding depends on refresh budget, ~30MB memory guidance, Lock Screen accessory families, iOS 17+ `containerBackground`, App Groups data sharing, or migration from `IntentConfiguration` to `AppIntentConfiguration`) — You name one concrete artifact you inspected (for example `.entitlements` / App Group id in project, `WidgetFamily` handling in source, `IPHONEOS_DEPLOYMENT_TARGET`, or the exact reference subsection you used) **or** you drop or downgrade the finding to an open question. 4. **Protocol** — Pre-report steps in [review-verification-protocol](../review-verification-protocol/SKILL.md) are satisfied for this item (no finding if they are not). Use the issue format `[FILE:LINE] ISSUE_TITLE` for each reported finding. Hard gate 4 is the full pre-report checklist for this skill’s review type.
© existential-birds · Apache-2.0 · existential-birds/beagle