Hono Agent Skills

Три скилла Hono дают агенту справку по API фреймворка и проверку маршрутов через Hono CLI без запуска сервера

  • 18 ★ репозитория
  • Последний коммит
  • MIT
СкиллОфициальный

Расширенный доступ

Почему такой уровень

  • Агент правит код сервиса и запускает команды Hono CLI, `npm install` и скрипты проекта
  • Для приложения на Void скилл запускает `npx void db seed --yes`, и локальная база сбрасывается
Все причины и проверки

honojs/skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/hono-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент правит код сервиса и запускает команды Hono CLI, `npm install` и скрипты проекта
  • Для приложения на Void скилл запускает `npx void db seed --yes`, и локальная база сбрасывается

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор подключается как плагин Claude Code или ставится через `npx skills add` и содержит три скилла. Скилл `hono` хранит прямо в тексте справку по API: маршрутизацию, контекст, middleware, JSX, валидацию, RPC, потоковые ответы и хелперы. Для остального он отсылает к свежей документации на hono.dev в формате Markdown. Приложение агент проверяет через Hono CLI: `npx hono routes` печатает маршруты, `npx hono request /path` отправляет запрос внутри процесса, `npx hono batch` гоняет цепочку запросов с проверкой статуса и тела. Скилл `hono-jsx` строит интерфейс на `hono/jsx`: серверные страницы через `jsxRenderer`, Vite с `vite-ssr-components` на Cloudflare Workers и клиентские компоненты через `hono/jsx/dom`. React он запрещает. Скилл `hono-void` проверяет приложение на фреймворке Void, построенном поверх Hono: данные страницы в JSON, действия и ошибки валидации.

Для кого. Разработчикам API и веб-приложений на Hono, особенно на Cloudflare Workers, которые хотят, чтобы агент знал свежий API и сам проверял маршруты.

Подходит, если

  • Новый сервис на Hono стартует с шаблона `create-hono`, и агент добавляет маршруты и middleware по справке
  • После правки обработчика агент проверяет ответ через `npx hono request`, а не поднимает dev-сервер
  • Серверные страницы с макетом и формами пишут на `hono/jsx` без React
  • Сценарий из нескольких запросов, например создать запись и прочитать ее по возвращенному id, гоняют одним вызовом `hono batch`
  • Приложение на Void проверяют через `x-voidpages: true`, чтобы получить данные страницы в JSON

Не подходит, если

  • Проект на Express, Fastify или Next.js: скиллы знают только Hono
  • Интерфейс строится на React: скилл `hono-jsx` прямо запрещает его подключать
  • Нужна проверка клиентской логики с версткой и CSS: `hono browse` исполняет JavaScript в happy-dom, но макета там нет

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

Добавь в мой сервис на Hono маршрут POST /notes с валидацией тела и проверь его через hono request, не запуская сервер

Ограничения

  • Нужен Hono CLI как зависимость разработки: `npm install -D @hono/cli`.
  • Сами скиллы пока ссылаются на тег `@hono/cli@next` и содержат пометки заменить его после выхода версии 1.0.
  • Для `hono browse` отдельно ставится `happy-dom`, у него нет верстки и CSS.
  • Основная ориентация на Cloudflare Workers с Vite, для других сред есть раздел про их настройку.
  • В `hono-void` команда `npx void db seed --yes` сбрасывает локальную базу.

Как отключить. В Claude Code удалите плагин через меню `/plugin`, а при установке через `npx skills add` удалите папки `hono`, `hono-jsx` и `hono-void` из каталога скиллов. Зависимость убирает `npm uninstall @hono/cli`.

Частые вопросы

Как поставить скиллы Hono в Claude Code?

Добавьте маркетплейс командой `/plugin marketplace add honojs/skills`, затем выполните `/plugin install hono@hono`. Для других агентов есть `npx skills add honojs/skills`. Кроме скиллов, понадобится Hono CLI: `npm install -D @hono/cli`.

Чем проверка через Hono CLI лучше запуска dev-сервера?

CLI загружает приложение внутри процесса и вызывает `app.request()`, поэтому поднимать сервер не нужно, и ответ приходит в JSON. Привязки Cloudflare (KV, D1, R2, переменные) доступны в `c.env` автоматически, без флагов.

Какие скиллы входят в набор?

Три: `hono` со справкой по API и проверкой через CLI, `hono-jsx` для интерфейса на `hono/jsx` и `hono-void` для приложений на фреймворке Void. Автор отмечает, что скиллы для остальной экосистемы Hono запланированы.

Можно ли подключить React?

Нет, скилл `hono-jsx` запрещает ставить `react`, `react-dom` и плагин для React. Серверные компоненты в нем обычные функции, а интерактивность выносится в клиентские компоненты на `hono/jsx/dom`.

Как проверить страницу, которой нужен JavaScript?

Поставьте `happy-dom` и запустите `npx hono browse / --fill "Shop name=Hono Ramen" --click 'button[type=submit]'`. Команда загрузит страницу, выполнит ее скрипты и вернет итоговый адрес, видимый текст, значения форм и ошибки консоли.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Команда hono ищет по документации фреймворка, отправляет запросы в приложение без сервера и собирает облегченную сборку.

CLIМинимальный доступ367Звезды репозитория

Сотни скиллов по провайдерам учат агента принимать вебхуки, проверять подписи и разбирать события; примеры для Express и FastAPI.

СкиллМинимальный доступ101Звезды репозитория

Официальные скиллы Clerk учат агента подключать аутентификацию к Next.js, React, Vue, Expo, Swift и Android

ПлагинРасширенный доступ94Звезды репозитория

Скиллы для серверного Swift и линтер swift-server-lint: Swift NIO, Hummingbird, Postgres, конкурентность и хук проверки.

ПлагинРасширенный доступ64Звезды репозитория
Официальный

Скилл подключает справочник Scalar к приложению по описанию OpenAPI: интеграции, аутентификация, темы и миграция со Swagger UI

СкиллМинимальный доступ16,4 тыс.Звезды репозитория
Официальный

Скилл PowerSync: агент настраивает офлайн-синхронизацию через CLI, пишет Sync Streams и чинит зависший статус Syncing

СкиллРасширенный доступ22Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Hono Agent Skills (эта карточка)да18
Cloudflare Skillsнет3 359официальный набор Cloudflare про Workers, Durable Objects и wrangler, а здесь API самого веб-фреймворка Hono и его проверка через CLI
Скиллы Next.jsнет143 488плагин для Next.js с переходом на Cache Components, а этот набор строит приложения на Hono и его JSX

Коротко о README

Страница дает две команды установки, коротко описывает каждый из трех скиллов с перечнем возможностей и называет единственное требование, Hono CLI. Внизу указаны автор Юсукэ Вада и лицензия MIT.

Бейдж для README

Сообщить о проблеме