hummingbird — скилл для Claude Code: что делает и как установить
Скилл помогает писать серверный код на Swift с Hummingbird 2: настраивать маршруты, контексты запросов и ответы HTTP.
npx skills add wendylabsinc/claude-skills --skill hummingbird -a claude-codeЧто делает hummingbird
Скилл даёт агенту справочные знания о Hummingbird 2 — HTTP-фреймворке для Swift, построенном на SwiftNIO и поддерживающем Swift Concurrency. Он пригодится при разработке сервера или REST API на Swift, настройке маршрутизации и middleware, работе с RequestContext и аутентификацией.
В примерах разобраны группы маршрутов, параметры пути и запроса, декодирование JSON из тела запроса и разные способы сформировать ответ. Отдельно показаны ChildRequestContext для контекста с гарантированными свойствами и EditedResponse для управления статусом и заголовками. Это подсказки по коду, а не готовое приложение.
Чтобы собрать приложение с Hummingbird, добавьте пакет в Package.swift и подключите продукт Hummingbird к target. Пример установки использует версию от 2.0.0; проекту нужно учитывать эту зависимость.
Какие задачи решает
- настроить маршруты по HTTP-методу и пути
- сгруппировать API-маршруты по префиксу
- прочитать параметры пути и query string
- декодировать JSON-запрос в Swift-тип
- вернуть JSON с заданным статусом и заголовками
Примеры запросов агенту
- Помоги добавить в мой Swift-сервер маршрут
GET /users/{id}и прочитатьidиз контекста. - Покажи, как сгруппировать маршруты API и добавить middleware аутентификации в Hummingbird 2.
- Разбери, как декодировать JSON в запросе и вернуть
EditedResponseсо статусом создания.
Как установить hummingbird
1Через Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a claude-code2Вручную: положить файлы
~/.claude/skills/hummingbird/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hummingbird/
1Через Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a codex2Вручную: положить файлы
.agents/skills/hummingbird/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a cursor2Вручную: положить файлы
.cursor/skills/hummingbird/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wendylabsinc/claude-skills hummingbird2Вручную: положить файлы
.github/skills/hummingbird/SKILL.md1Через Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a gemini-cli2Командой платформы
gemini skills install https://github.com/wendylabsinc/claude-skills --path hummingbirdВручную: положить файлы
.devin/skills/hummingbird/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wendylabsinc/claude-skills --skill hummingbird -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hummingbird
Как установить hummingbird в Claude Code?
Выполните npx skills add wendylabsinc/claude-skills --skill hummingbird -a claude-code. Файл скилла находится по пути ~/.claude/skills/hummingbird/SKILL.md.
Что делает скилл hummingbird?
Он помогает агенту отвечать на вопросы о разработке HTTP-серверов и REST API на Hummingbird 2 для Swift. Охватывает маршруты, контексты запросов, middleware и формирование ответов.
Как в Hummingbird передать в маршрут контекст с авторизованным пользователем?
В примере скилла ChildRequestContext преобразует родительский контекст в контекст, где пользователь доступен как обязательное свойство. Для этого показаны AuthRequestContext и BearerAuthenticator.
