Develop Hono applications efficiently using the Hono CLI. Ideal for operations teams building web services, APIs, and serverless functions. Integrates with existing workflows and connects to cloud platforms.
git clone https://github.com/yusukebe/hono-skill.gitHono Skill is an agent skill that enables developers to build Hono web applications efficiently with integrated API reference and request testing capabilities. It provides inline knowledge of Hono's core features including routing, context, middleware, JSX, validation, RPC, streaming, and helper functions. The skill uses the Hono CLI to test requests directly within your development environment. It supports Claude Code and skills.sh installation methods and optionally integrates with the hono-docs MCP server for real-time documentation search and retrieval. This skill helps developers accelerate web service and API development by combining language model assistance with practical testing tools.
[{"step":"Install the Hono CLI globally using your package manager. For Node.js projects, run `npm install -g hono-cli`. For Deno, use `deno install -A https://deno.land/x/hono_cli/cli.ts`. Verify installation with `hono --version`.","tip":"Ensure you have Node.js (v18+) or Deno installed. Use `nvm` or `asdf` to manage Node versions if needed."},{"step":"Run the scaffold command with your project specifications. Example: `hono new my-api --language typescript --framework drizzle --target cloudflare`. This will generate a project structure tailored to your needs.","tip":"Use `--help` with the CLI to explore additional options like `--template` for pre-configured setups (e.g., `hono new --template auth-api`)."},{"step":"Customize the generated files (e.g., `src/routes/users.ts`) to match your business logic. Add or modify endpoints, middleware, and database models as required.","tip":"For complex applications, use the Hono CLI to generate additional routes or middleware: `hono generate route users` or `hono generate middleware auth`."},{"step":"Configure environment variables in the `.env` file (auto-generated) and update the database connection in `drizzle.config.ts` or your ORM configuration.","tip":"Use `hono env` to validate your environment variables before deployment. Tools like `dotenv-cli` can help manage local development environments."},{"step":"Deploy your application using the provided commands (e.g., `wrangler deploy` for Cloudflare or `vercel --prod` for Vercel). Monitor logs for errors and iterate as needed.","tip":"Set up CI/CD pipelines (e.g., GitHub Actions) to automate deployments. Use `hono deploy --dry-run` to test deployment configurations locally."}]
Building REST APIs with Hono routing and middleware
Creating serverless functions with Hono context and helpers
Testing API requests during development without leaving your IDE
Implementing request validation and streaming responses
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/yusukebe/hono-skillCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Use the Hono CLI to scaffold and deploy a new Hono application for [PURPOSE: e.g., 'a RESTful API for user authentication'] with the following specifications: [LANGUAGE: TypeScript/JavaScript], [FRAMEWORK: e.g., Hono + Drizzle ORM], and [DEPLOYMENT_TARGET: e.g., Cloudflare Workers, Vercel, or Deno Deploy]. Include authentication middleware, a basic CRUD endpoint for [ENTITY: e.g., 'users'], and configure environment variables for [DATABASE_URL, JWT_SECRET]. Generate the project structure, install dependencies, and provide deployment commands.
### Hono Application Scaffolding Report
**Project Structure:**
```
my-hono-api/
├── src/
│ ├── index.ts # Main application entry
│ ├── routes/
│ │ ├── auth.ts # Authentication routes (JWT middleware)
│ │ └── users.ts # CRUD endpoints for users
│ ├── models/
│ │ └── user.ts # Drizzle ORM schema for users
│ └── middleware/
│ └── auth.ts # JWT validation middleware
├── drizzle.config.ts # Drizzle ORM configuration
├── package.json # Dependencies and scripts
└── .env # Environment variables (auto-generated)
```
**Key Files Generated:**
1. **`src/index.ts`**:
```typescript
import { Hono } from 'hono';
import { auth } from './routes/auth';
import { users } from './routes/users';
const app = new Hono();
app.route('/auth', auth);
app.route('/users', users);
export default app;
```
2. **`src/routes/users.ts`**:
```typescript
import { Hono } from 'hono';
import { db } from '../models/user';
import { eq } from 'drizzle-orm';
const app = new Hono();
// GET /users - List all users
app.get('/', async (c) => {
const users = await db.select().from(usersTable).all();
return c.json({ users });
});
// POST /users - Create a user
app.post('/', async (c) => {
const { name, email } = await c.req.json();
const newUser = await db.insert(usersTable).values({ name, email }).returning();
return c.json({ user: newUser[0] }, 201);
});
```
3. **Deployment Commands:**
```bash
# Install dependencies
npm install hono @hono/auth-js drizzle-orm better-sqlite3
# Run locally
npm run dev
# Deploy to Cloudflare Workers
npm install -g wrangler
wrangler deploy
# Deploy to Vercel
vercel --prod
```
**Environment Variables:**
```env
DATABASE_URL="better-sqlite3://./db.sqlite"
JWT_SECRET="your-super-secret-key-here"
```
**Next Steps:**
1. Run `npm run dev` to test locally.
2. Configure your database connection in `drizzle.config.ts`.
3. Deploy using the provided commands (adjust for your target platform).
4. Add rate-limiting and CORS middleware in production.
**Estimated Time to Deploy:** ~15 minutes (including dependencies and testing).IronCalc is a spreadsheet engine and ecosystem
Get more done every day with Microsoft Teams – powered by AI
Enterprise workflow automation and service management platform
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan