# relevancekit

Скилл подсказывает агенту, как через RelevanceKit задавать контекст виджета на Apple Watch: время, место, тренировки, сон, подключённое железо.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3000 установок · ★ 1237
- Автор: dpearson2699
- Лицензия: LicenseRef-Unknown · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dpearson2699/swift-ios-skills/tree/HEAD/skills/relevancekit/SKILL.md
- Обновлён: 2026-07-31
- HTML: https://affpapa.org/nevibecode/skills/relevancekit

## Что делает

RelevanceKit — это фреймворк Apple, который сообщает системе, когда виджет уместен в Smart Stack на часах. Скилл даёт агенту рабочие шаблоны: `RelevantContext` с датой или геолокацией, `WidgetRelevance` со списком атрибутов, группировку карточек через `WidgetRelevanceGroup`.

Внутри два пути. Первый — добавить метод `relevance()` к существующему `AppIntentTimelineProvider`, код общий для iOS и watchOS. Второй — собрать виджет целиком на `RelevanceConfiguration` и `RelevanceEntriesProvider`: тогда карточка появляется только при совпадении условий. Второй вариант работает на watchOS 26+.

Часть сигналов требует разрешений. Для геолокации приложение запрашивает доступ, а расширение виджета объявляет `NSWidgetWantsLocation`; для тренировок и сна нужен HealthKit с конкретными типами чтения. Автор помечает материал как beta-sensitive и советует сверяться с документацией Apple перед утверждениями о поведении RelevanceKit.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill relevancekit -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/relevancekit/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/relevancekit/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill relevancekit -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/relevancekit/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill relevancekit -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/relevancekit/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dpearson2699/swift-ios-skills relevancekit
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/relevancekit/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill relevancekit -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/relevancekit
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/relevancekit/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill relevancekit -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dpearson2699/swift-ios-skills/tree/HEAD/skills/relevancekit/SKILL.md

## Когда брать
- показать виджет в Smart Stack только в нужное время
- привязать карточку к геолокации пользователя
- собрать несколько карточек под ближайшие события календаря
- учесть состояние тренировки или расписания сна
- не запутаться в том, какие типы относятся к RelevanceKit, а какие к WidgetKit

## Примеры запросов агенту
- Добавь relevance() к моему AppIntentTimelineProvider, чтобы виджет всплывал в Smart Stack перед встречей
- Сделай виджет на RelevanceEntriesProvider, который появляется только рядом с офисом
- Проверь, какие разрешения нужны для location- и fitness-сигналов в моём watchOS-виджете

## Похожие
- [widgetkit](https://affpapa.org/nevibecode/skills/prisma-labs-dev-widgetkit.md) — скилл · 458 установок
- [watchOS](https://affpapa.org/nevibecode/skills/watchos.md) — скилл · 579 установок
- [axiom-watchos](https://affpapa.org/nevibecode/skills/axiom-watchos.md) — скилл · 934 установки
- [apple-hig-expert](https://affpapa.org/nevibecode/skills/apple-hig-expert.md) — скилл · 662 установки
- [hig-components-status](https://affpapa.org/nevibecode/skills/hig-components-status.md) — скилл · 636 установок
- [axiom-health](https://affpapa.org/nevibecode/skills/axiom-health.md) — скилл · 953 установки

Из того же набора: [dpearson2699/swift-ios-skills](https://affpapa.org/nevibecode/by/dpearson2699/swift-ios-skills.md) — 86 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md