swift-networking

Q: How do I install swift-networking?

Run npx skills add https://github.com/johnrogers/claude-swift-engineering --skill swift-networking in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/swift-networking/ (personal) or .claude/skills/swift-networking/ (project).

by johnrogersMobile

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.

Installs: 159
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/johnrogers/claude-swift-engineering --skill swift-networking

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads swift-networking automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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	Setting up NWConnection for TCP/UDP, choosing between APIs
Connection States	Handling `.waiting`, `.ready`, `.failed` transitions
iOS 26+ Networking	Using NetworkConnection with async/await, TLV framing, Coder protocol
Migration Guide	Moving from sockets, CFSocket, SCNetworkReachability, URLSession
Troubleshooting	Debugging timeouts, TLS failures, connection issues

Core Workflow

Choose transport (TCP/UDP/QUIC) based on use case
Create NWConnection (iOS 12+) or NetworkConnection (iOS 26+)
Set up state handler for connection lifecycle
Start connection on appropriate queue
Send/receive data with proper error handling
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

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.
Blocking the main thread — Never call receive() on the main queue. Use a background DispatchQueue or Task for all network operations.
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.
Not handling network transitions — WiFi/cellular switches or network loss aren't always detected automatically. Implement viability checks and state monitoring for robust apps.
Improper error recovery — Network errors need retry logic with backoff. Immediately failing on transient errors (timeouts, temporary loss) creates poor UX.

FAQ

What does the swift-networking skill do?

How do I install swift-networking?

Run npx skills add https://github.com/johnrogers/claude-swift-engineering --skill swift-networking in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/swift-networking/ (personal) or .claude/skills/swift-networking/ (project).

Which AI agents can use swift-networking?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is swift-networking safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains swift-networking?

It is published by johnrogers in johnrogers/claude-swift-engineering. It has 159 recorded installs.