avkit — скилл для Claude Code: что делает и как установить
Помогает настраивать воспроизведение медиа в iOS: от полноэкранных плееров AVPlayerViewController до оверлеев в SwiftUI VideoPlayer и фонового режима PiP.
npx skills add dpearson2699/swift-ios-skills --skill avkit -a claude-codeЧто делает avkit
Скилл содержит шаблоны интеграции медиаплееров на Swift для iOS. Он направляет агента при настройке AVPlayerViewController в UIKit и VideoPlayer в SwiftUI. Плеер нельзя сабклассить: инструкции требуют использовать стандартный контроллер или оборачивать его в дочерний UIViewController.
Отдельное внимание уделено фоновым режимам, AirPlay и Picture-in-Picture. Для запуска плавающего окна обязательно включить фоновый режим аудио в UIBackgroundModes, настроить категорию .playback в AVAudioSession и отложить вызов setActive(true) до старта воспроизведения. Если дорожка содержит только аудио или кодек не поддерживается, режим PiP не включится даже при верных системных настройках.
Чтобы экран не моргал чёрным цветом при загрузке, код отслеживает свойство isReadyForDisplay. Для расширенного контроля над событиями плеера в SwiftUI скилл подсказывает обёртку через UIViewControllerRepresentable.
Какие задачи решает
- встроить системный плеер AVPlayerViewController в UIKit
- настроить фоновое воспроизведение и режим Picture-in-Picture
- добавить интерактивный оверлей поверх SwiftUI VideoPlayer
- предотвратить чёрную вспышку перед началом показа видео
Примеры запросов агенту
- Покажи, как встроить AVPlayerViewController как дочерний контроллер в контейнер
- Настрой AVAudioSession и фоновый режим для работы Picture-in-Picture в iOS
- Сделай плеер на SwiftUI VideoPlayer с логотипом поверх видео
Как установить avkit
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill avkit -a claude-code2Вручную: положить файлы
~/.claude/skills/avkit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/avkit/
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill avkit -a codex2Вручную: положить файлы
.agents/skills/avkit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill avkit -a cursor2Вручную: положить файлы
.cursor/skills/avkit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills avkit2Вручную: положить файлы
.github/skills/avkit/SKILL.md1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill avkit -a gemini-cli2Командой платформы
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/avkitВручную: положить файлы
.devin/skills/avkit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill avkit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о avkit
Как установить avkit в Claude Code?
Выполните в терминале команду npx skills add dpearson2699/swift-ios-skills --skill avkit -a claude-code. Файлы скилла сохранятся в локальный каталог конфигурации.
Что делает скилл avkit?
Он предоставляет агенту готовые правила и сниппеты для работы с медиаплеерами в iOS на базе AVKit и AVFoundation. Скилл помогает внедрять видеоплееры в UIKit и SwiftUI, управлять AirPlay и режимом «картинка в картинке».
Почему Picture-in-Picture может не работать даже после настройки скилла?
Режим PiP требует готовности AVPlayerItem с валидным видеорядом. Если воспроизводится только звук, кодек не поддерживается системой или не включён фоновый режим аудио в UIBackgroundModes, окно PiP не запустится.
