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

swift-networking — скилл для Claude Code: что делает и как установить

Скилл swift-networking помогает проектировать сетевой слой на базе Network.framework в Swift, настраивать сокеты, переключаться между Wi-Fi и сотовой сетью и разгружать главный поток.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

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

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

~/.claude/skills/swift-networking/SKILL.md

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

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

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

Все скиллы по теме «Мобильная разработка» →
swift-nio wendylabsinc Помогает разрабатывать TCP/UDP-сервисы и разбирать проблемы SwiftNIO. Охватывает работу с бинарными протоколами, буферами и переходом на async/await. CX Codex +1 ★ 64звёзд репо ios-networking dpearson2699 Скилл ios-networking для сетевого слоя iOS/macOS на Swift: запросы через URLSession с async/await, разбор ошибок, повторы и пагинация. CX Codex +1 4 700установок axiom-networking CharlesWiltgen Скилл axiom-networking с правилами и справочниками для сетевого кода в Apple-приложениях. Внутри — маршрутизация по типу задачи, диагностика сбоев и паттерны для URLSession и Network.framework. CX Codex +1 1 600установок swift-testing-expert AvdLee Скилл swift-testing-expert помогает писать и разбирать тесты на Swift Testing: макросы #expect и #require, теги, параметризация, миграция с XCTest. CX Codex +1 5 700установок swift-concurrency dpearson2699 Скилл swift-concurrency помогает устранять ошибки Sendable и изоляции акторов в Swift 6.2+, настраивать фоновые задачи и применять SE-0466. CX Codex +1 4 600установок swift-expert https://github.com/Jeffallan Скилл swift-expert для Claude Code: архитектура, SwiftUI, async/await, акторы и тесты на Swift. Ведёт агента при написании и разборе кода под iOS и macOS. CX Codex +1 4 500установок

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

Весь набор →
swift-test-creator Субагент swift-test-creator для Claude Code и Codex пишет юнит- и интеграционные тесты на Swift Testing с @Test, #expect и #require. Создаёт тесты для готовой реализации. CX Codex ★ 233звёзд репо swift-documenter Субагент swift-documenter генерирует и обновляет файлы README и документирующие комментарии в коде на Swift. Пригодится после завершения фичи или при пересмотре документации пакета. CX Codex ★ 233звёзд репо swift-modernizer Субагент swift-modernizer находит устаревшие конструкции Swift и переносит их на async/await, современные API и SwiftUI. Он пригодится при поэтапной модернизации старого кода. CX Codex ★ 233звёзд репо reflect Команда reflect для Claude Code разбирает историю чата и настройки, а затем предлагает правки инструкций, команд и конфигурации. CX Codex +1 ★ 233звёзд репо ios-hig Скилл ios-hig помогает проектировать интерфейсы iOS с учётом рекомендаций Apple по доступности, визуальному оформлению и взаимодействию. Пригодится при создании экранов и проверке уже готовых элементов. CX Codex +1 ★ 233звёзд репо swift-engineer Субагент swift-engineer для Claude Code пишет код на чистом Swift без TCA: модели, сервисы, сеть и хранение в SQLite. Реализует фичи по готовому плану. CX Codex ★ 233звёзд репо grdb Помогает проектировать прямые запросы к SQLite, миграции и реактивные подписки через GRDB.swift в приложениях для iOS и macOS. CX Codex +1 ★ 233звёзд репо swift-diagnostics Скилл swift-diagnostics помогает разбирать сбои навигации, сборки и памяти в проектах iOS и macOS. Он ведёт по диагностическим шагам до проверки исправления. CX Codex +1 ★ 233звёзд репо

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

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