swift-networking — скилл для Claude Code: что делает и как установить
Скилл swift-networking помогает проектировать сетевой слой на базе Network.framework в Swift, настраивать сокеты, переключаться между Wi-Fi и сотовой сетью и разгружать главный поток.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает swift-networking
Скилл направляет Claude Code при работе с сетевыми соединениями Apple через NWConnection для iOS 12+ и современный NetworkConnection с async/await для iOS 26+. Он содержит правила выбора подходящего транспорта (TCP, UDP, QUIC), шаблоны обработки состояний .waiting, .ready или .failed, а также инструкции по миграции со старых BSD-сокетов, CFSocket и потоков URLSession.
Внутри заложены готовые схемы для безопасной работы с очередями: скилл отслеживает, чтобы вызовы receive() не попадали в основной UI-поток, предотвращает дедлоки из-за неверного подбора DispatchQueue и даёт правила для отката с временных сетевых сбоев через backoff.
Главное разделение зон ответственности прямое: для HTTP, HTTPS и WebSocket инструкции требуют оставаться на URLSession, а Network.framework подключать только ради низкоуровневого контроля, кастомных протоколов, UDP или p2p-связи.
Какие задачи решает
- настроить TCP, UDP или QUIC через NWConnection и NetworkConnection
- обработать переходы между Wi-Fi и мобильной связью без обрыва сессии
- мигрировать старый сетевой код с BSD-сокетов, CFSocket или SCNetworkReachability
- найти причины сбоев TLS и таймаутов в сетевых очередях
Примеры запросов агенту
- Настрой соединение через NWConnection для UDP с правильной обработкой состояний
- Помоги перевести сетевой код с CFSocket на NetworkConnection с async/await
- Разбери, почему receive() блокирует интерфейс и падает по таймауту
Как установить swift-networking
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineeringКоманда ставит плагин swift-engineering целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-networking -a claude-code3Вручную: положить файлы
~/.claude/skills/swift-networking/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swift-networking/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-networking -a codex2Вручную: положить файлы
.agents/skills/swift-networking/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-networking -a cursor2Вручную: положить файлы
.cursor/skills/swift-networking/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/swift-networking2Вручную: положить файлы
.github/skills/swift-networking/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-networking -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/swift-networkingВручную: положить файлы
.devin/skills/swift-networking/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swift-networking
Как установить swift-networking в Claude Code?
Выполните в терминале команду /plugin marketplace add johnrogers/claude-swift-engineering, а затем установите пакет командой /plugin install swift-engineering@claude-swift-engineering.
Для чего нужен этот скилл?
Он помогает реализовывать низкоуровневые сетевые протоколы в Swift на базе Network.framework, следить за состояниями подключений и корректно распределять очереди задач.
Когда скилл советует предпочесть URLSession вместо Network.framework?
Для стандартных запросов по HTTP, HTTPS, WebSocket или базовых потоков TLS скилл предписывает использовать привычный URLSession, а не усложнять архитектуру фреймворком.
Исходный текст
SKILL.md · MIT
--- name: swift-networking description: Use when implementing Network.framework connections (NWConnection, NetworkConnection), debugging connection failures, migrating from sockets/URLSession streams, or handling network transitions. Covers UDP/TCP patterns, structured concurrency networking (iOS 26+), and common anti-patterns. --- # Swift Networking Network.framework is Apple's modern networking API for TCP/UDP connections, replacing BSD sockets with smart connection establishment, user-space networking, and seamless mobility handling. ## Reference Loading Guide **ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake. | Reference | Load When | |-----------|-----------| | **[Getting Started](references/getting-started.md)** | Setting up NWConnection for TCP/UDP, choosing between APIs | | **[Connection States](references/connection-states.md)** | Handling `.waiting`, `.ready`, `.failed` transitions | | **[iOS 26+ Networking](references/ios26-networking.md)** | Using NetworkConnection with async/await, TLV framing, Coder protocol | | **[Migration Guide](references/migration.md)** | Moving from sockets, CFSocket, SCNetworkReachability, URLSession | | **[Troubleshooting](references/troubleshooting.md)** | Debugging timeouts, TLS failures, connection issues | ## Core Workflow 1. Choose transport (TCP/UDP/QUIC) based on use case 2. Create NWConnection (iOS 12+) or NetworkConnection (iOS 26+) 3. Set up state handler for connection lifecycle 4. Start connection on appropriate queue 5. Send/receive data with proper error handling 6. Handle network transitions (WiFi to cellular) ## When to Use Network.framework vs URLSession - **URLSession**: HTTP, HTTPS, WebSocket, simple TCP/TLS streams - **Network.framework**: UDP, custom protocols, low-level control, peer-to-peer, gaming ## Common Mistakes 1. **Ignoring state handlers** — Creating an NWConnection without a state change handler means you never learn when it's ready or failed. Always implement the state handler first. 2. **Blocking the main thread** — Never call `receive()` on the main queue. Use a background DispatchQueue or Task for all network operations. 3. **Wrong queue selection** — Using the wrong queue (UI queue for network work, or serial queue for concurrent reads) causes deadlocks or silent failures. Always explicit your queue choice. 4. **Not handling network transitions** — WiFi/cellular switches or network loss aren't always detected automatically. Implement viability checks and state monitoring for robust apps. 5. **Improper error recovery** — Network errors need retry logic with backoff. Immediately failing on transient errors (timeouts, temporary loss) creates poor UX.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering