Hono Api Scaffolder

This scaffolds Hono routes after you've already spun up a Cloudflare Workers project. It generates route files organized by resource (users, posts, auth), wires in Zod validation with @hono/zod-validator for type-safe request bodies, adds middleware for auth and CORS, and outputs an API_ENDPOINTS.md reference doc. The workflow is opinionated: one file per resource group, typed bindings for D1/KV/R2, and JSON error handling that won't silently break fetch clients. Use it when you need to add structured endpoints to an existing Worker rather than starting from scratch. It pairs with cloudflare-worker-builder or vite-flare-starter for the initial project shell.

skills.sh installs: 1.6K
GitHub stars: 1.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jezweb/claude-skills --skill hono-api-scaffolder --agent claude-code

Installs into .claude/skills of the current project.

Files

Hono API Scaffolder

Add structured API routes to an existing Cloudflare Workers project. This skill runs AFTER the project shell exists (via cloudflare-worker-builder or vite-flare-starter) and produces route files, middleware, and endpoint documentation.

Workflow

Step 1: Gather Endpoints

Determine what the API needs. Either ask the user or infer from the project description. Group endpoints by resource:

Users:    GET /api/users, GET /api/users/:id, POST /api/users, PUT /api/users/:id, DELETE /api/users/:id
Posts:    GET /api/posts, GET /api/posts/:id, POST /api/posts, PUT /api/posts/:id
Auth:     POST /api/auth/login, POST /api/auth/logout, GET /api/auth/me

Step 2: Create Route Files

One file per resource group. Use the template from assets/route-template.ts:

// src/routes/users.ts
import { Hono } from 'hono'
import { zValidator } from '@hono/zod-validator'
import { z } from 'zod'
import type { Env } from '../types'

const app = new Hono<{ Bindings: Env }>()

SKILL.md on GitHub