hummingbird — Claude Code skill: what it does, how to install
Get coding guidance for Hummingbird 2 in Swift, from HTTP routing and request contexts to response handling.
npx skills add wendylabsinc/claude-skills --skill hummingbird -a claude-codeWhat hummingbird does
This skill gives an agent reference material for building HTTP services with Hummingbird 2, a Swift framework built on SwiftNIO with Swift Concurrency support. Use it while working on a Swift server or REST API, especially when you need help with routing, middleware, request contexts, or authentication.
The examples cover route groups, path and query values, JSON request decoding, and several ways to produce an HTTP response. They also show how ChildRequestContext can expose a required property to protected routes, and how EditedResponse carries a status and headers alongside a response body. The material guides code changes; it does not provide a finished application.
A project using Hummingbird needs the package added in Package.swift and the Hummingbird product included in its target. The setup example starts at version 2.0.0, so check that dependency when applying the guidance to a project.
What it helps with
- route requests by HTTP method and path
- group API endpoints under a shared prefix
- read path and query values in handlers
- decode a JSON request into a Swift type
- return JSON with a chosen status and headers
Example prompts for the agent
- Add a
GET /users/{id}route to my Swift server and readidfrom the request context. - Show how to group API routes and attach authentication middleware in Hummingbird 2.
- Explain how to decode a JSON request and return an
EditedResponsewith a creation status.
How to install hummingbird
1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a claude-code2Manually: put the files in place
~/.claude/skills/hummingbird/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hummingbird/
1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a codex2Manually: put the files in place
.agents/skills/hummingbird/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a cursor2Manually: put the files in place
.cursor/skills/hummingbird/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wendylabsinc/claude-skills hummingbird2Manually: put the files in place
.github/skills/hummingbird/SKILL.md1Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a gemini-cli2Platform CLI
gemini skills install https://github.com/wendylabsinc/claude-skills --path hummingbirdManually: put the files in place
.devin/skills/hummingbird/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -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 hummingbird
How do I install hummingbird in Claude Code?
Run npx skills add wendylabsinc/claude-skills --skill hummingbird -a claude-code. The skill file is at ~/.claude/skills/hummingbird/SKILL.md.
What does the hummingbird skill do?
It gives an agent guidance for Swift HTTP services and REST APIs built with Hummingbird 2. Topics include routing, request contexts, middleware, and HTTP responses.
How can a Hummingbird route receive a context with an authenticated user?
The examples use ChildRequestContext to turn a parent context into one where the user is a required property. They also show AuthRequestContext and BearerAuthenticator.
