Hono Agent Skills

Three Hono skills give an agent the framework API reference and let it check routes through the Hono CLI without a server

  • 18 ★ on the repository
  • Last commit
  • MIT
SkillOfficial

Extended access

Why this level

  • The agent edits service code and runs Hono CLI commands, `npm install` and project scripts
  • For a Void app the skill runs `npx void db seed --yes`, which resets the local database
All reasons and checks

honojs/skills

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/hono-agent-skills

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The agent edits service code and runs Hono CLI commands, `npm install` and project scripts
  • For a Void app the skill runs `npx void db seed --yes`, which resets the local database

This is third-party code. Review the repository files before installing.

What it does

The set connects as a Claude Code plugin or installs through `npx skills add` and holds three skills. The `hono` skill keeps an API reference inline: routing, context, middleware, JSX, validation, RPC, streaming and helpers. For everything else it points to the current documentation on hono.dev in Markdown. The agent checks the app through the Hono CLI: `npx hono routes` prints the routes, `npx hono request /path` sends a request in-process, and `npx hono batch` runs a chain of requests with status and body checks. The `hono-jsx` skill builds UI on `hono/jsx`: server-rendered pages through `jsxRenderer`, Vite with `vite-ssr-components` on Cloudflare Workers and client components through `hono/jsx/dom`. It forbids React. The `hono-void` skill checks an app on the Void framework, which is built on Hono: page data as JSON, actions and validation errors.

Who it is for. Developers of APIs and web apps on Hono, especially on Cloudflare Workers, who want an agent that knows the current API and checks routes itself.

Good fit when

  • A new Hono service starts from the `create-hono` template, and the agent adds routes and middleware from the reference
  • After editing a handler the agent checks the response with `npx hono request` instead of starting a dev server
  • Server-rendered pages with a layout and forms are written on `hono/jsx` without React
  • A multi-request flow, such as creating a record and reading it by the returned id, runs in one `hono batch` call
  • A Void app is checked with `x-voidpages: true` to get page data as JSON

Not a fit when

  • The project is on Express, Fastify or Next.js: the skills know Hono only
  • The UI is built on React: the `hono-jsx` skill forbids bringing it in
  • You need to test client logic with layout and CSS: `hono browse` runs JavaScript in happy-dom, which has no layout

Example request

Add a POST /notes route with body validation to my Hono service and check it with hono request without starting a server

Limitations

  • The Hono CLI is required as a dev dependency: `npm install -D @hono/cli`.
  • The skills themselves still point to the `@hono/cli@next` tag and carry notes to change it after version 1.0 ships.
  • `hono browse` needs `happy-dom` installed separately, and it has no layout or CSS.
  • The main focus is Cloudflare Workers with Vite, and other runtimes have a setup section.
  • In `hono-void`, the `npx void db seed --yes` command resets the local database.

How to disable. In Claude Code remove the plugin through the `/plugin` menu, and if you installed with `npx skills add`, delete the `hono`, `hono-jsx` and `hono-void` folders from the skills directory. `npm uninstall @hono/cli` removes the dependency.

FAQ

How do I install the Hono skills in Claude Code?

Add the marketplace with `/plugin marketplace add honojs/skills`, then run `/plugin install hono@hono`. For other agents there is `npx skills add honojs/skills`. Besides the skills you need the Hono CLI: `npm install -D @hono/cli`.

Why is the Hono CLI check better than a dev server?

The CLI loads the app in-process and calls `app.request()`, so no server is needed and the answer arrives as JSON. Cloudflare bindings (KV, D1, R2, vars) reach `c.env` automatically, with no flags.

Which skills are in the set?

Three: `hono` with the API reference and CLI checks, `hono-jsx` for UI on `hono/jsx`, and `hono-void` for apps on the Void framework. The author notes that skills for the rest of the Hono ecosystem are planned.

Can I bring in React?

No, the `hono-jsx` skill forbids installing `react`, `react-dom` and the React plugin. Server components there are plain functions, and interactivity moves into client components on `hono/jsx/dom`.

How do I test a page that needs JavaScript?

Install `happy-dom` and run `npx hono browse / --fill "Shop name=Hono Ramen" --click 'button[type=submit]'`. The command loads the page, runs its scripts and returns the final URL, visible text, form values and console errors.

Discussion

No questions or reviews yet.

Skills

The hono command searches framework docs, sends requests to an app without starting a server and builds a slimmer bundle.

CLIMinimal access367Repository stars

Hundreds of per-provider skills teach an agent to receive webhooks, verify signatures and handle events, with code examples.

SkillMinimal access101Repository stars

Official Clerk skills that teach an agent to add authentication to Next.js, React, Vue, Expo, Swift and Android apps

PluginExtended access94Repository stars

Skills for server-side Swift and the swift-server-lint linter: Swift NIO, Hummingbird, Postgres, concurrency and a lint hook.

PluginExtended access64Repository stars

Scalar API Reference skill for agents

Scalar API Reference skill

Official

A skill that adds a Scalar reference to an app from its OpenAPI description: integrations, authentication, themes, migration from Swagger UI

SkillMinimal access16.4KRepository stars
Official

The PowerSync skill: the agent sets up offline app sync through the CLI, writes Sync Streams and debugs a stuck Syncing status

SkillExtended access22Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialRepository starsMain difference
Hono Agent Skills (this card)yes18
Cloudflare Skillsno3,359Cloudflare's official set on Workers, Durable Objects and wrangler, while here it is the API of the Hono web framework and checking it through the CLI
Next.js skillsno143,488a plugin for Next.js with the move to Cache Components, while this set builds apps on Hono and its JSX

README in short

The page gives two install commands, briefly describes each of the three skills with its features and names the one requirement, the Hono CLI. The author, Yusuke Wada, and the MIT license close the page.

README badge

Report a problem