swift-nio — Claude Code skill: networking guidance and setup
Get SwiftNIO guidance for TCP/UDP services, binary protocols, and event-loop issues. Useful when building network code or moving from futures to async/await.
npx skills add wendylabsinc/claude-skills --skill swift-nio -a claude-codeWhat swift-nio does
The skill directs the agent to inspect Package.swift and consider Swift Concurrency before changing chains of EventLoopFuture. For new code, it points toward NIOAsyncChannel. Keep event loops unblocked; CPU-heavy work belongs on a dispatch queue or in NIOThreadPool.
Its reference files cover channels and pipelines, event loops, ByteBuffer, and binary codecs such as ByteToMessageDecoder and MessageToByteEncoder. They give the agent material for TCP or UDP implementations, message parsing, and bridging futures with async/await. Waiting synchronously on an EventLoopFuture from its own event loop can deadlock, so that constraint matters when diagnosing hangs.
To add the skill to Claude Code, run the supplied npx installation command. The installed skill file is at ~/.claude/skills/swift-nio/SKILL.md.
What it helps with
- diagnose a blocked event loop
- build a TCP or UDP service
- decode a binary protocol
- fix a
ChannelPipelinetype mismatch - migrate
EventLoopFuturecode to async/await
Example prompts for the agent
- Inspect
Package.swiftand suggest an async/await approach for this SwiftNIO networking code. - Find why this TCP server blocks its event loop and propose a fix.
- Help me decode binary messages with
ByteToMessageDecoderandByteBuffer.
How to install swift-nio
1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill swift-nio -a claude-code2Manually: put the files in place
~/.claude/skills/swift-nio/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/swift-nio/
1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill swift-nio -a codex2Manually: put the files in place
.agents/skills/swift-nio/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill swift-nio -a cursor2Manually: put the files in place
.cursor/skills/swift-nio/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wendylabsinc/claude-skills swift-nio2Manually: put the files in place
.github/skills/swift-nio/SKILL.md1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill swift-nio -a gemini-cli2Platform CLI
gemini skills install https://github.com/wendylabsinc/claude-skills --path swift-nioManually: put the files in place
.devin/skills/swift-nio/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill swift-nio -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about swift-nio
How do I install swift-nio in Claude Code?
Run npx skills add wendylabsinc/claude-skills --skill swift-nio -a claude-code. The skill file is located at ~/.claude/skills/swift-nio/SKILL.md.
What does swift-nio do?
It guides an agent through SwiftNIO networking work, from channels and binary message handling to event-loop problems. It also points out when Swift Concurrency can replace future chains.
How does the skill approach EventLoopFuture?
It asks the agent to consider Swift Concurrency before proposing changes to future chains. Use .get() to bridge a future into async code; synchronously waiting on a future from its own event loop can deadlock.
