CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hono-api-scaffolder

Scaffold Hono API routes for Cloudflare Workers. Produces route files, middleware, typed bindings, Zod validation, error handling, and API_ENDPOINTS.md documentation. Use after a project is set up with cloudflare-worker-builder or vite-flare-starter, when you need to add API routes, create endpoints, or generate API documentation.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable scaffolding guide with excellent reference/asset navigation and copy-near-ready code. Its main weaknesses are the absence of any validation or verification step in the workflow, and inline code that duplicates the bundle's asset and reference files.

Suggestions

Add a final validation step to the workflow: after wiring routes, run a typecheck and `wrangler dev`, then smoke-test `GET /api/health` and one route per group before generating API_ENDPOINTS.md (addresses workflow_clarity).

Move the "RPC Type Safety" section into references/hono-patterns.md — the Reference Files table already lists RPC as covered there — and reference it with one line (addresses conciseness).

Replace the full inline auth-middleware and error-handler code blocks with one-line descriptions pointing to assets/middleware-template.ts and assets/error-handler.ts, keeping only the CORS snippet inline since it is not in the assets (addresses conciseness and progressive_disclosure).

DimensionReasoningScore

Conciseness

The body is lean and code-first with no conceptual padding, but there is duplication: the inline auth-middleware and error-handler code mirror assets/middleware-template.ts and assets/error-handler.ts, and the "RPC Type Safety" section duplicates what the Reference Files table already says references/hono-patterns.md covers. This is efficient with minor trimmable content (score 4) rather than the score-5 "every token earns its place".

4 / 5

Actionability

Concrete, near-executable guidance throughout — full route handlers with zValidator, the index.ts wiring, the Env types, and the install command "pnpm add @hono/zod-validator zod". Placeholders like "// ... insert logic" and "// Validate token..." leave minor gaps, so it is mostly executable (score 4) rather than fully copy-paste ready (score 5).

4 / 5

Workflow Clarity

The six steps (gather endpoints, create route files, add middleware, wire routes, create types, generate docs) are clearly sequenced, but there is no validation or verification checkpoint anywhere — no typecheck, no `wrangler dev` smoke test of /api/health after wiring. This matches the score-3 anchor ("sequence present but checkpoints missing") rather than score 4, which requires most checkpoints present.

3 / 5

Progressive Disclosure

Good structure: a "Reference Files" When/Read table and an "Assets" File/Purpose table clearly signal one-level-deep references, and all five referenced files exist with substantive content (verified). The minor gap is that substantial template code (route, middleware, error handler) is inlined in the body while also living in the assets, so content is not fully "appropriately split" (score 4, not 5).

4 / 5

Total

15

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states concrete deliverables in third person, includes an explicit and specific 'Use when' clause with natural trigger phrases, and carves out a distinct niche by naming the predecessor skills it runs after. No weaknesses identified.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete deliverables — "route files, middleware, typed bindings, Zod validation, error handling, and API_ENDPOINTS.md documentation" — giving comprehensive coverage of what the skill produces, in third-person voice ("Scaffold", "Produces"). It exceeds the score-4 anchor ("several specific actions; minor gaps") because the output list is complete rather than gapped.

5 / 5

Completeness

It explicitly answers both questions: the "what" in "Scaffold Hono API routes for Cloudflare Workers. Produces route files, middleware..." and the "when" in "Use after a project is set up with cloudflare-worker-builder or vite-flare-starter, when you need to add API routes, create endpoints, or generate API documentation." This mirrors the score-5 anchor's structure (clear what plus explicit 'Use when...' clause with concrete trigger phrases); the score-4 anchor's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Natural user phrases are present: "add API routes, create endpoints, or generate API documentation", along with synonyms (routes/endpoints), the domain terms "Hono" and "Cloudflare Workers", and the concrete artifact "API_ENDPOINTS.md". Coverage matches the score-5 anchor's comprehensiveness (synonyms and concrete file names) rather than the score-4 anchor's "a few natural terms missing".

5 / 5

Distinctiveness Conflict Risk

The niche is clear (Hono API routes on Cloudflare Workers) and it is explicitly sequenced "after a project is set up with cloudflare-worker-builder or vite-flare-starter", which distinguishes it from generic scaffolding skills and from its own predecessor skills. Conflict risk is minimal, matching the score-5 anchor; it does not fall to 4 because the named predecessor skills further delimit when it applies.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jezweb/claude-skills

Path

archive/plugins/cloudflare/skills/hono-api-scaffolder/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.