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

hono · oakoss — скилл для Claude Code: что делает и как установить

Скилл по веб-фреймворку Hono для создания API и edge-функций на Cloudflare Workers, Bun, Deno и Node.js.

MIT 112 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill hono -a claude-code
Открыть на GitHub

Что делает hono

Скилл передаёт агенту правила и готовые паттерны Hono: настройку роутинга, типизированный контекст через дженерик Hono<{ Variables: MyVars }> и цепочки middleware. Он учитывает специфику платформ: для Cloudflare Workers, Bun и Deno требуется export default app, а сжатие compress() подключать не нужно, потому что эти платформы сжимают трафик сами.

Внутри собраны указания по связке с Zod через @hono/zod-validator, работе с WebSocket и тестированию эндпоинтов с помощью testClient без запуска локального сервера. Без цепочки вызовов app.route().route() экспортировать типы для RPC-клиента hc не выйдет: если выгрузить тип экземпляра приложения вместо цепочки маршрутов, автовывод типов на клиенте сломается.

Какие задачи решает

  • настроить роутинг и валидацию схем Zod для Cloudflare Workers
  • организовать сквозную типизацию клиента через Hono RPC
  • протестировать эндпоинты через testClient без запуска HTTP-сервера
  • передавать типизированные переменные между middleware

Примеры запросов агенту

  • Сделай API на Hono для Cloudflare Workers с валидацией схемы пользователя через Zod
  • Настрой Hono RPC с цепочкой маршрутов и типизированным клиентом hc
  • Напиши тесты эндпоинта авторизации через testClient из hono/testing

Как установить hono

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill hono -a claude-code

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

~/.claude/skills/hono/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hono

Как установить hono в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill hono -a claude-code.

Что делает скилл hono?

Он объясняет агенту синтаксис Hono, правильный порядок регистрации middleware, настройку RPC-типизации и тонкости работы с edge-платформами.

Для каких задач Hono не подходит?

Фреймворк не предназначен для тяжеловесных монолитов с глубокой привязкой к внутренним библиотекам Node.js и полностраничного рендеринга вместо Next.js или Remix.

Исходный текст

SKILL.md · MIT
---
name: hono
description: 'Hono ultrafast web framework for edge and server runtimes. Use when building APIs, middleware chains, or edge functions on Cloudflare Workers, Bun, Node.js, or Deno. Use for hono, api, routing, middleware, cloudflare-workers, edge, rpc, validator, context.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://hono.dev/docs/'
user-invocable: false
---

# Hono

## Overview

Hono is a small, ultrafast web framework built on Web Standards that runs on any JavaScript runtime including Cloudflare Workers, Bun, Deno, Node.js, Vercel, and AWS Lambda. Application code is portable across runtimes; only the entry point and adapter differ per platform.

**When to use:** Edge-first APIs, Cloudflare Workers services, multi-runtime applications, lightweight REST/RPC servers, middleware-heavy request pipelines, type-safe client-server communication.

**When NOT to use:** Full-stack SSR frameworks (use Next.js/Remix), heavy ORM-driven monoliths where Express ecosystem maturity matters, applications that need deep Node.js-only APIs without Web Standard equivalents.

## Quick Reference

| Pattern           | API                                         | Key Points                                  |
| ----------------- | ------------------------------------------- | ------------------------------------------- |
| Basic routing     | `app.get('/path', handler)`                 | Supports get, post, put, delete, patch, all |
| Path parameters   | `app.get('/user/:id', handler)`             | Access via `c.req.param('id')`              |
| Regex constraints | `app.get('/post/:id{[0-9]+}', handler)`     | Inline regex in path parameter              |
| Wildcard          | `app.get('/files/*', handler)`              | Matches any sub-path                        |
| Route grouping    | `app.route('/api', subApp)`                 | Mount sub-applications                      |
| Middleware        | `app.use(middleware())`                     | Executes in registration order              |
| Path middleware   | `app.use('/auth/*', jwt(...))`              | Scope middleware to paths                   |
| JSON response     | `c.json({ key: 'value' })`                  | Sets Content-Type automatically             |
| Text response     | `c.text('hello')`                           | Returns plain text                          |
| HTML response     | `c.html('<h1>Hi</h1>')`                     | Returns HTML content                        |
| Status + header   | `c.status(201)`, `c.header('X-Key', 'val')` | Chain before response                       |
| Redirect          | `c.redirect('/new-path', 301)`              | Default status is 302                       |
| Request body      | `c.req.json()`, `c.req.parseBody()`         | JSON or form data parsing                   |
| Query params      | `c.req.query('page')`                       | Single query parameter                      |
| Context variables | `c.set('user', data)` / `c.get('user')`     | Type-safe middleware data passing           |
| Zod validation    | `zValidator('json', schema)`                | `@hono/zod-validator` package               |
| RPC client        | `hc<AppType>(url)`                          | End-to-end type-safe API calls              |
| Error handler     | `app.onError((err, c) => ...)`              | Global error handling                       |
| Not found         | `app.notFound((c) => ...)`                  | Custom 404 handler                          |
| Environment       | `c.env.BINDING_KEY`                         | Access runtime bindings/env vars            |
| Adapter helper    | `env(c)` from `hono/adapter`                | Unified env access across runtimes          |
| WebSocket         | `upgradeWebSocket()` from runtime adapter   | WebSocket helper with RPC support           |
| Test client       | `testClient(app)` from `hono/testing`       | Type-safe testing without HTTP server       |
| JSX streaming     | `jsxRenderer({ stream: true })`             | SSR streaming with Suspense support         |

## Common Mistakes

| Mistake                                                             | Correct Pattern                                                                      |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Registering middleware after handlers                               | Register middleware before the handlers it should apply to                           |
| Using `app.route()` without chaining for RPC types                  | Chain route methods (`app.route('/a', a).route('/b', b)`) and export `typeof routes` |
| Forgetting `export default app` for edge runtimes                   | Cloudflare Workers, Bun, and Deno require the default export                         |
| Using `compress()` on Cloudflare Workers or Deno Deploy             | These platforms compress automatically; skip the middleware                          |
| Mixing Hono and middleware versions in Deno                         | Pin all `hono` imports to the same version to avoid type mismatches                  |
| Wrapping `next()` in try/catch inside middleware                    | Hono catches thrown errors and routes to `app.onError()`; `next()` never throws      |
| Defining routes with `app.get()` but exporting `typeof app` for RPC | Export the type of the chained route variable, not the app instance                  |
| Using `new Hono()` without generics for typed context               | Pass `Hono<{ Variables: MyVars }>` to enable typed `c.get()`/`c.set()`               |
| Returning `c.json()` without status for created resources           | Pass status as second argument: `c.json(data, 201)`                                  |
| Not using `createMiddleware()` for reusable middleware              | Import from `hono/factory` to preserve type inference when extracting middleware     |

## Delegation

> If the `zod` or `typescript-patterns` skill is available, delegate schema and type-level tasks to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill typescript-patterns`
>
> If a Cloudflare Workers skill is available, delegate platform-specific configuration to it.

## References

- [Route definitions, path params, groups, and method handlers](references/routing.md)
- [Built-in and custom middleware patterns](references/middleware.md)
- [Context object, request parsing, and response helpers](references/context-and-helpers.md)
- [Zod validator middleware and request validation](references/validation.md)
- [RPC client and end-to-end type safety](references/rpc-client.md)
- [Runtime adapters for Cloudflare, Bun, Node.js, Deno, and more](references/adapters.md)
- [Testing with testClient, WebSocket helper, and JSX streaming](references/testing-and-websocket.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Бэкенд и API» →

Сначала — hono от других авторов.

hono honojs Скилл подсказывает агенту API Hono и заставляет проверять приложение через Hono CLI, а не временными скриптами. CX Codex +1 4 500установок hono suhaibjanjua Помогает писать API и приложения на Hono: настраивать маршруты и middleware, создавать типизированный RPC-клиент для Cloudflare Workers, Deno, Bun и Node.js. CX Codex +1 54установок hono-api-scaffolder jezweb Скилл hono-api-scaffolder создаёт маршруты Hono для Cloudflare Workers с проверкой Zod, обработкой ошибок и документацией API. Нужен после подготовки каркаса проекта. CX Codex +1 1 600установок hono-typescript Mindrally Скилл hono-typescript для Claude Code задаёт правила написания API на Hono и TypeScript под Cloudflare Workers, Deno, Bun и Node.js. Запускается, когда агент пишет роуты, middleware, валидацию или обработку ошибок в Hono-проекте. CX Codex +1 872установок bun-hono-integration secondsky Скилл bun-hono-integration для Claude Code и Codex подсказывает агенту, как строить API на Hono под Bun: маршруты, middleware, валидация через Zod, RPC-клиент. Работает в проектах, уже запущенных на Bun. CX Codex +1 473установок hono-routing secondsky Скилл hono-routing для работы с Hono: маршруты, middleware, валидация через Zod или Valibot, RPC-клиент с выводом типов. Помогает избежать 12 типичных ошибок при построении API. CX Codex +1 256установок hono-rpc bobmatnyc Скилл hono-rpc объясняет, как связать сервер и клиент Hono через типы TypeScript: экспорт AppType и клиент hc без кодогенерации. CX Codex +1 460установок hono-core bobmatnyc Скилл hono-core для Claude Code, Codex, Cursor и других платформ с базой знаний по Hono — маршрутизация, контекст, хендлеры и паттерны ответов. Покрывает мультирантаймное развёртывание на Cloudflare Workers, Deno, Bun и Node.js. CX Codex +1 509установок

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

Весь набор →
better-auth Подгружает агенту справочник по better-auth: конфиг, плагины, стратегии сессий и типовые ошибки. Даёт справку при настройке входа, 2FA и организаций. CX Codex +1 114установок meta-skill-creator Скилл meta-skill-creator помогает создавать и проверять агентские скиллы по открытому стандарту Agent Skills. Он пригодится при подготовке SKILL.md, структуры папок и файлов для распространения. CX Codex +1 114установок figma-developer Скилл figma-developer для Claude Code получает из Figma цвета, шрифты и иконки через REST API и собирает CSS-переменные и React-компоненты. Автоматизирует перенос изменений макета в код. CX Codex +1 114установок tanstack-store Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок astro Скилл Claude Code объясняет агенту Astro: коллекции контента, островную гидратацию, view transitions и режимы рендеринга. Описывает статичные сайты с вкраплениями интерактива. CX Codex +1 111установок db-enforcer Скилл db-enforcer для Claude Code проверяет целостность PostgreSQL-схем и согласованность с Prisma. Включается при проектировании схем, подготовке миграций и настройке RLS. CX Codex +1 109установок electricsql Скилл для ИИ-кодинга по ElectricSQL: как стримить строки Postgres в клиент через Shapes, фильтровать их и не пускать запись мимо своего API. CX Codex +1 109установок trpc trpc — скилл для Claude Code, который помогает строить типобезопасные API на TypeScript с tRPC v11. Он подключается к задачам с роутерами, процедурами, React-клиентом и тестами. CX Codex +1 109установок

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

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