К основному содержанию
скилл CX Codex

widgetkit-code-review — скилл для Claude Code: ревью кода WidgetKit

Скилл widgetkit-code-review проверяет код виджетов на WidgetKit по чек-листу: таймлайн, вёрстка, настраиваемые интенты, память. Пригодится перед релизом виджета и после переезда на iOS 17.

Apache-2.0 121 установок ★ 89 обновлён 2026-09-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add existential-birds/beagle --skill widgetkit-code-review -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/widgetkit-code-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/widgetkit-code-review/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
widgetkit Prisma-Labs-Dev Подключает к агенту справочник по Apple WidgetKit. Пригодится при настройке таймлайнов, провайдеров данных и семейств виджетов для iOS. CX Codex +1 567установок liquid-glass-design affaan-m Скилл liquid-glass-design для Claude Code подсказывает, как собирать интерфейсы в стиле Liquid Glass из iOS 26. Описывает паттерны для SwiftUI, UIKit и WidgetKit под iOS 26+. CX Codex +1 7 300установок relevancekit dpearson2699 Скилл подсказывает агенту, как через RelevanceKit задавать контекст виджета на Apple Watch: время, место, тренировки, сон, подключённое железо. CX Codex +1 3 300установок swiftui-design-principles arjitj2 Скилл swiftui-design-principles задаёт ИИ-агенту правила сетки, типографики и цветов для SwiftUI и WidgetKit, чтобы интерфейс выглядел как нативное приложение, а не как сгенерированная разметка. CX Codex +1 1 300установок axiom-watchos CharlesWiltgen Скилл axiom-watchos для разработки приложений под watchOS: структура, Smart Stack, complications, Watch Connectivity, фоновые задачи и миграция с ClockKit. CX Codex +1 1 000установок apple-app-services Fandhe-AI Скилл apple-app-services для Claude Code даёт агенту справочники по нативным фреймворкам Apple. Помогает писать код со StoreKit 2, CloudKit, WidgetKit, Core Location и Sign in with Apple. CX Codex +1 104установок

Из того же набора68

Весь набор →
review-feedback-schema Скилл review-feedback-schema для Claude Code задаёт CSV-схему результатов код-ревью и помогает оценивать качество проверок. Ведёт журнал решений по найденным проблемам. CX Codex +1 124установок combine-code-review Скилл combine-code-review проверяет код на Combine на ошибки в подписках, операторах, управлении памятью и обработке ошибок. Пригодится перед ревью Swift-кода с Combine. CX Codex +1 123установок receive-feedback Скилл receive-feedback разбирает замечания из код-ревью по фактам, а не из вежливости: каждый пункт проверяется по коду, получает вердикт с доказательством и только потом правится. CX Codex +1 123установок reference-docs Скилл reference-docs помогает писать справочные страницы для API и функций: таблицы параметров, возвращаемые значения, ошибки, запускаемые примеры. CX Codex +1 121установок pydantic-ai-model-integration Скилл pydantic-ai-model-integration помогает настроить провайдеров LLM, цепочки fallback, стриминг и лимиты токенов в библиотеке PydanticAI. CX Codex +1 120установок review-ai-writing Скилл review-ai-writing находит следы текстов нейросетей в документации, комментариях к коду, текстах коммитов и описаниях пулреквестов. Пригодится при проверке репозитория на канцелярский слог и роботизированные фразы. CX Codex +1 119установок wish-ssh-code-review Скилл wish-ssh-code-review проверяет код SSH-серверов на базе Go-библиотеки Charmbracelet Wish: порядок middleware, работу с PTY, ключи хоста и корректное завершение работы. CX Codex +1 119установок urlsession-code-review Скилл urlsession-code-review разбирает сетевой код на URLSession в iOS и macOS: статус-коды, кэш, таймауты и фоновые сессии. Находки идут с привязкой file:line. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой