Why should I import Zod from @hono/zod-openapi instead of the standard zod package?

Importing from @hono/zod-openapi extends the standard Zod object with the .openapi() method, which is required for generating the metadata used in OpenAPI specifications.

What is the importance of the operationId in route definitions?

The operationId is used as the method name when generating client SDKs, ensuring your API has clean, predictable, and developer-friendly client interfaces instead of auto-generated path-based names.

How does this skill handle API documentation?

It uses your Zod schemas and route definitions to automatically generate OpenAPI (Swagger) specifications, ensuring your code implementation and documentation remain perfectly in sync.

Does this support Hono's RPC mode?

Yes, it includes patterns for chaining routes to enable end-to-end type safety between your server and client using Hono's RPC client (hc).

Hono API Framework

Name: Hono API Framework
Author: agents-inc

byagents-inc

0•

API 开发

Builds type-safe REST APIs using Hono and Zod with automatic OpenAPI specification generation and schema validation.

This skill provides a comprehensive framework for developing production-grade APIs using Hono and @hono/zod-openapi. It enforces best practices such as modular route architecture, schema-driven validation, and automatic documentation generation. By leveraging Zod schemas as a single source of truth for both runtime validation and OpenAPI metadata, it ensures end-to-end type safety, consistent error handling, and seamless client generation for multi-consumer environments.

主要功能

01Automatic OpenAPI specification generation from Zod schemas

02End-to-end type safety via Hono's RPC client integration

03Type-safe request and response validation using @hono/zod-openapi

04Standardized error handling with machine-parseable error codes

05Modular route management with app.route() and OpenAPIHono

060 GitHub stars

使用场景

01Implementing multi-client backends with auto-generated SDK support

02Building public-facing REST APIs that require interactive Swagger documentation

03Creating high-performance microservices with strict schema validation requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agents-inc/skills api-framework-hono

For use in Claude.ai and ChatGPT

主要功能

01Automatic OpenAPI specification generation from Zod schemas

02End-to-end type safety via Hono's RPC client integration

03Type-safe request and response validation using @hono/zod-openapi

04Standardized error handling with machine-parseable error codes

05Modular route management with app.route() and OpenAPIHono

060 GitHub stars

使用场景

01Implementing multi-client backends with auto-generated SDK support

02Building public-facing REST APIs that require interactive Swagger documentation

03Creating high-performance microservices with strict schema validation requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agents-inc/skills api-framework-hono

For use in Claude.ai and ChatGPT