[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79AA92WGYD3354HEDVG7TAS":3,"skill-same:01M79AA92WGYD3354HEDVG7TAS":139},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":51,"commitSha":52,"skillDirectory":53,"forksCount":14,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":56,"install":57,"resources":70},"01M79AA92WGYD3354HEDVG7TAS","hono-routing",null,"Type-safe Hono APIs with routing, middleware, RPC. Use for request validation, Zod\u002FValibot validators, or encountering middleware type inference, validation hook, RPC errors.","Elogic360\u002Fsoftware-factory","Elogic360","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F156535519?v=4","01M74NH3F0RB13PWB7JZDE2V80","elogic360","01M74NH3FPC65082MDZVMFHDM3",0,"MIT","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: hono-routing\ndescription: \"Type-safe Hono APIs with routing, middleware, RPC. Use for request validation, Zod\u002FValibot validators, or encountering middleware type inference, validation hook, RPC errors.\"\n\nlicense: MIT\nmetadata:\n  version: \"2.0.0\"\n  package_version: \"4.10.6\"\n  last_verified: \"2025-11-21\"\n  errors_prevented: 12\n  templates_included: 9\n  references_included: 6\n  keywords:\n    - hono\n    - hono routing\n    - hono middleware\n    - hono rpc\n    - hono validator\n    - zod validator\n    - valibot validator\n    - type-safe api\n    - hono context\n    - hono error handling\n    - HTTPException\n    - c.req.valid\n    - middleware composition\n    - hono hooks\n    - typed routes\n    - hono client\n    - middleware response not typed\n    - hono validation failed\n    - hono rpc type inference\n---\n# Hono Routing & Middleware\n\n**Status**: Production Ready ✅\n**Last Updated**: 2025-11-21\n**Dependencies**: None (framework-agnostic)\n**Latest Versions**: hono@4.10.6, zod@4.1.12, valibot@1.1.0\n\n---\n\n## Quick Start (5 Minutes)\n\n### Install\n\n```bash\nbun add hono@4.10.6  # preferred\n# or: bun add hono@4.10.6\n```\n\n**Why Hono:**\n- **Fast**: Built on Web Standards, runs on any JavaScript runtime\n- **Lightweight**: ~10KB, no dependencies\n- **Type-safe**: Full TypeScript support with type inference\n- **Flexible**: Works on Cloudflare Workers, Deno, Bun, Node.js, Vercel\n\n### Basic App\n\n```typescript\nimport { Hono } from 'hono'\n\nconst app = new Hono()\n\napp.get('\u002F', (c) => {\n  return c.json({ message: 'Hello Hono!' })\n})\n\nexport default app\n```\n\n**CRITICAL:**\n- Use `c.json()`, `c.text()`, `c.html()` for responses\n- Return the response (don't use `res.send()` like Express)\n- Export app for runtime\n\n### Add Validation\n\n```bash\nbun add zod@4.1.12 @hono\u002Fzod-validator@0.7.4\n```\n\n```typescript\nimport { zValidator } from '@hono\u002Fzod-validator'\nimport { z } from 'zod'\n\nconst schema = z.object({\n  name: z.string(),\n  age: z.number(),\n})\n\napp.post('\u002Fuser', zValidator('json', schema), (c) => {\n  const data = c.req.valid('json')\n  return c.json({ success: true, data })\n})\n```\n\n---\n\n## Critical Rules\n\n### Always Do\n\n✅ **Return responses** from handlers (c.json, c.text, c.html, etc.)\n\n✅ **Use c.req.valid('source')** after validation middleware to get typed data\n\n✅ **Export app** for deployment (Cloudflare Workers, Bun, Deno, Node.js)\n\n✅ **Use validation middleware** (zValidator, vValidator) for type-safe request data\n\n✅ **Call await next()** in middleware to pass control to next handler\n\n✅ **Use HTTPException** for expected errors (returns proper HTTP status)\n\n✅ **Use template tag validators** (zValidator, vValidator) not hooks\n\n✅ **Define context types** for custom variables (`Hono\u003C{ Variables: { ... } }>`)\n\n✅ **Use sub-apps** (app.route()) for organizing large APIs\n\n✅ **Type your RPC routes** (`export type AppType = typeof routes`) for client\n\n### Never Do\n\n❌ **Never forget to return** response from handlers\n\n❌ **Never use req.json() directly** without validation - use c.req.valid()\n\n❌ **Never mix validation hooks** with middleware - use middleware only\n\n❌ **Never forget await next()** in middleware - breaks middleware chain\n\n❌ **Never use res.send()** - not available (use c.json(), c.text(), etc.)\n\n❌ **Never skip error handling** - use app.onError() for global handler\n\n❌ **Never access unvalidated data** after validation middleware\n\n❌ **Never use blocking operations** in middleware - breaks async chain\n\n❌ **Never hardcode origins** in CORS - use environment variables\n\n❌ **Never skip type exports** for RPC - client won't have types\n\n---\n\n## Top 5 Errors (See references\u002Ftop-errors.md for all 12)\n\n### Error #1: Middleware Response Not Typed\n**Problem**: Middleware returns response but route handler still executes\n**Solution**: Don't return from middleware if you want chain to continue - only set variables\n```typescript\n\u002F\u002F ❌ Wrong - breaks chain\napp.use('*', (c) => {\n  return c.json({ error: 'Unauthorized' }, 401)\n})\n\n\u002F\u002F ✅ Correct - throw HTTPException instead\napp.use('*', (c, next) => {\n  if (!isAuthorized) {\n    throw new HTTPException(401, { message: 'Unauthorized' })\n  }\n  await next()\n})\n```\n\n### Error #2: Validation Hook vs Middleware Confusion\n**Problem**: Using validation hooks instead of middleware\n**Solution**: Always use middleware validators (zValidator, vValidator)\n```typescript\n\u002F\u002F ❌ Wrong - hooks deprecated\napp.post('\u002Fuser', (c) => {\n  const data = c.req.json\u003CUser>() \u002F\u002F No runtime validation!\n})\n\n\u002F\u002F ✅ Correct - middleware with runtime validation\napp.post('\u002Fuser', zValidator('json', schema), (c) => {\n  const data = c.req.valid('json') \u002F\u002F Validated & typed!\n})\n```\n\n### Error #3: Missing await next() in Middleware\n**Problem**: Middleware doesn't call next(), breaking chain\n**Solution**: Always call await next() unless returning early\n```typescript\n\u002F\u002F ❌ Wrong - chain broken\napp.use('*', (c) => {\n  console.log('Log')\n  \u002F\u002F Missing await next()!\n})\n\n\u002F\u002F ✅ Correct\napp.use('*', async (c, next) => {\n  console.log('Log')\n  await next()\n})\n```\n\n### Error #4: Context Variable Type Inference\n**Problem**: c.get() and c.set() not typed\n**Solution**: Define Variables type in Hono constructor\n```typescript\n\u002F\u002F ❌ Wrong - no types\nconst app = new Hono()\nc.set('user', { id: '123' }) \u002F\u002F Not typed\nconst user = c.get('user') \u002F\u002F any\n\n\u002F\u002F ✅ Correct - typed\ntype Variables = {\n  user: { id: string; name: string }\n}\nconst app = new Hono\u003C{ Variables: Variables }>()\nc.set('user', { id: '123', name: 'Alice' })\nconst user = c.get('user') \u002F\u002F Fully typed!\n```\n\n### Error #5: RPC Type Inference Not Working\n**Problem**: Client doesn't have types from server routes\n**Solution**: Export AppType and use hc\u003CAppType>\n```typescript\n\u002F\u002F Server\nconst routes = app.get('\u002Fusers', (c) => c.json([]))\nexport type AppType = typeof routes \u002F\u002F Export this!\n\n\u002F\u002F Client\nimport { hc } from 'hono\u002Fclient'\nimport type { AppType } from '.\u002Fserver'\n\nconst client = hc\u003CAppType>('http:\u002F\u002Flocalhost:8787') \u002F\u002F Fully typed!\n```\n\n**Load `references\u002Ftop-errors.md` for all 12 errors with detailed solutions.**\n\n---\n\n## Common Use Cases\n\n### Use Case 1: Basic REST API\n**When**: Simple CRUD operations\n**Quick Pattern**:\n```typescript\napp.get('\u002Fusers', (c) => c.json({ users: [] }))\napp.post('\u002Fusers', (c) => c.json({ created: true }))\napp.get('\u002Fusers\u002F:id', (c) => c.json({ user: {} }))\napp.put('\u002Fusers\u002F:id', (c) => c.json({ updated: true }))\napp.delete('\u002Fusers\u002F:id', (c) => c.json({ deleted: true }))\n```\n**Load**: `references\u002Fsetup-guide.md` → Complete Example\n\n### Use Case 2: Request Validation (Zod)\n**When**: Need type-safe request validation\n**Quick Pattern**:\n```typescript\nimport { zValidator } from '@hono\u002Fzod-validator'\nimport { z } from 'zod'\n\napp.post('\u002Fuser',\n  zValidator('json', z.object({\n    name: z.string(),\n    email: z.string().email(),\n  })),\n  (c) => {\n    const data = c.req.valid('json') \u002F\u002F Typed!\n    return c.json(data)\n  }\n)\n```\n**Load**: `references\u002Fvalidation-libraries.md`\n\n### Use Case 3: Type-Safe RPC\n**When**: Full-stack TypeScript with shared types\n**Load**: `references\u002Frpc-guide.md` + `templates\u002Frpc-pattern.ts`\n\n### Use Case 4: Middleware Composition\n**When**: Authentication, logging, rate limiting\n**Load**: `references\u002Fmiddleware-catalog.md` + `templates\u002Fmiddleware-composition.ts`\n\n### Use Case 5: Custom Context Variables\n**When**: Share data between middleware and routes\n**Load**: `templates\u002Fcontext-extension.ts`\n\n---\n\n## When to Load References\n\n**Load `references\u002Fsetup-guide.md` when**:\n- User needs complete setup walkthrough\n- User asks about deployment to different runtimes\n- User needs CRUD API example\n- User wants to try alternative validators (Valibot, ArkType, Typia)\n\n**Load `references\u002Ftop-errors.md` when**:\n- Encountering any of the 12 documented errors\n- User has middleware type issues\n- User confused about validation hooks vs middleware\n- User needs troubleshooting or debugging\n\n**Load `references\u002Fcommon-patterns.md` when**:\n- User asks for code examples or best practices\n- User needs route grouping, error handling, file upload patterns\n- User wants streaming, WebSocket, or pagination examples\n\n**Load `references\u002Fmiddleware-catalog.md` when**:\n- User needs built-in middleware (cors, logger, jwt, cache, compress, etag)\n- User wants to create custom middleware\n- User asks about authentication or authorization\n\n**Load `references\u002Frpc-guide.md` when**:\n- User building full-stack TypeScript app\n- User wants type-safe client\u002Fserver communication\n- User asks about hono\u002Fclient or RPC patterns\n\n**Load `references\u002Fvalidation-libraries.md` when**:\n- User comparing Zod vs Valibot vs ArkType vs Typia\n- User needs validation examples for each library\n- User asks about performance or bundle size\n\n---\n\n## Configuration Reference\n\n### Minimal Configuration\n\n```typescript\nimport { Hono } from 'hono'\n\nconst app = new Hono()\n\napp.get('\u002F', (c) => c.json({ message: 'Hello' }))\n\nexport default app\n```\n\n### Production Configuration\n\n```typescript\nimport { Hono } from 'hono'\nimport { cors } from 'hono\u002Fcors'\nimport { logger } from 'hono\u002Flogger'\nimport { HTTPException } from 'hono\u002Fhttp-exception'\n\ntype Variables = {\n  user: { id: string; name: string }\n  requestId: string\n}\n\nconst app = new Hono\u003C{ Variables: Variables }>()\n\n\u002F\u002F Global middleware\napp.use('*', logger())\napp.use('*', async (c, next) => {\n  c.set('requestId', crypto.randomUUID())\n  await next()\n})\n\napp.use('*', cors({\n  origin: process.env.ALLOWED_ORIGINS?.split(',') || [],\n  credentials: true,\n}))\n\n\u002F\u002F Routes\napp.route('\u002Fapi', apiRoutes)\n\n\u002F\u002F Global error handler\napp.onError((err, c) => {\n  if (err instanceof HTTPException) {\n    return c.json(\n      { error: err.message },\n      err.status\n    )\n  }\n\n  console.error(err)\n  return c.json(\n    { error: 'Internal Server Error' },\n    500\n  )\n})\n\n\u002F\u002F 404 handler\napp.notFound((c) => {\n  return c.json({ error: 'Not Found' }, 404)\n})\n\nexport default app\n```\n\n---\n\n## Using Bundled Resources\n\n### References (references\u002F)\n\n- **setup-guide.md** - Complete 6-step setup (install → deploy)\n- **top-errors.md** - All 12 errors with solutions\n- **common-patterns.md** - 7 production patterns (RPC, middleware, error handling, file upload)\n- **middleware-catalog.md** - Built-in middleware reference (cors, logger, jwt, cache)\n- **rpc-guide.md** - Type-safe RPC client\u002Fserver guide\n- **validation-libraries.md** - Comparison of Zod, Valibot, ArkType, Typia\n\n### Templates (templates\u002F)\n\n- **routing-patterns.ts** - Route examples (params, query, wildcard, grouping)\n- **validation-zod.ts** - Zod validation examples\n- **validation-valibot.ts** - Valibot validation examples\n- **middleware-composition.ts** - Auth, rate limiting, logging middleware\n- **error-handling.ts** - HTTPException and global error handler\n- **context-extension.ts** - Custom context variables\n- **rpc-pattern.ts** - RPC server setup\n- **rpc-client.ts** - RPC client usage\n- **package.json** - Dependencies configuration\n\n---\n\n## Dependencies\n\n**Required**:\n- `hono@^4.10.2` - Core framework\n\n**Choose ONE validator** (recommended):\n- `zod@^4.1.12` + `@hono\u002Fzod-validator@^0.7.4` (most popular)\n- `valibot@^1.1.0` + `@hono\u002Fvalibot-validator@^0.5.3` (smaller bundle)\n- `arktype@^2.0.0` + `@hono\u002Farktype-validator@^0.1.0` (fastest runtime)\n- `typia@^7.0.0` + `@hono\u002Ftypia-validator@^0.1.0` (compile-time validation)\n\n**Optional**:\n- `@hono\u002Fnode-server` - Node.js adapter\n- `@cloudflare\u002Fworkers-types` - TypeScript types for Workers\n\n---\n\n## Official Documentation\n\n- **Hono**: https:\u002F\u002Fhono.dev\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fhono (17.8k ⭐)\n- **API Reference**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fapi\u002Fhono\n- **Routing**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fapi\u002Frouting\n- **Middleware**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fguides\u002Fmiddleware\n- **Validation**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fguides\u002Fvalidation\n- **RPC**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fguides\u002Frpc\n- **Examples**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fhono\u002Ftree\u002Fmain\u002Fexamples\n\n---\n\n## Comparison: Hono vs Alternatives\n\n| Feature          | Hono      | Express   | Fastify   |\n| ---------------- | --------- | --------- | --------- |\n| **Size**         | ~10KB     | ~200KB    | ~100KB    |\n| **TypeScript**   | ✅ Native  | ⚠️ Types  | ✅ Native  |\n| **Type Inference**| ✅ Full   | ❌ No     | ⚠️ Limited |\n| **RPC**          | ✅ Built-in| ❌ No     | ❌ No     |\n| **Edge Runtime** | ✅ Yes    | ❌ No     | ❌ No     |\n| **Validation**   | ✅ Plugin  | ⚠️ Manual | ✅ Plugin  |\n| **Speed**        | Very Fast | Fast      | Very Fast |\n\n**Recommendation**:\n- **Use Hono if**: TypeScript, edge runtime, full type inference, small bundle\n- **Use Express if**: Legacy Node.js app, large ecosystem needed\n- **Use Fastify if**: Node.js only, need fastest Node.js framework\n\n---\n\n## Production Examples\n\n**Verified working projects**:\n\n1. **Cloudflare Workers API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fcloudflare-workers\n2. **Bun REST API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fbun\n3. **Deno API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fdeno\n4. **Node.js API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fnodejs\n\n---\n\n## Secure Installation\n\nWhen installing Hono and middleware packages, follow supply chain security best practices:\n\n- **Block post-install scripts** — `npm config set ignore-scripts true` (or Bun: disabled by default)\n- **Cooldown period** — Wait 7 days for new package versions to be vetted by the community\n- **Audit before installing** — Run `socket package score npm \u003Cpkg>` or use `socket npm install \u003Cpkg>` to check packages\n\nLoad the `dependency-upgrade` skill for full security configuration including Socket CLI integration, cooldown setup, lockfile validation, and CI enforcement.\n\n## Complete Setup Checklist\n\n- [ ] Installed Hono (`bun add hono`)\n- [ ] Installed validator (Zod, Valibot, ArkType, or Typia)\n- [ ] Created basic app with routes\n- [ ] Added validation middleware to routes\n- [ ] Configured CORS for cross-origin requests\n- [ ] Added global error handler (app.onError)\n- [ ] Added 404 handler (app.notFound)\n- [ ] Configured context types for custom variables\n- [ ] Tested routes locally\n- [ ] Deployed to target runtime (Cloudflare, Bun, Deno, Node.js)\n\n---\n\n**Questions? Issues?**\n\n1. Check `references\u002Ftop-errors.md` for all 12 errors and solutions\n2. Review `references\u002Fsetup-guide.md` for complete setup walkthrough\n3. See `references\u002Fcommon-patterns.md` for production patterns\n4. Check `references\u002Fmiddleware-catalog.md` for built-in middleware\n5. See `references\u002Frpc-guide.md` for type-safe client\u002Fserver\n6. Check official docs: https:\u002F\u002Fhono.dev\n","# Hono Routing & Middleware\n\n**Status**: Production Ready ✅\n**Last Updated**: 2025-11-21\n**Dependencies**: None (framework-agnostic)\n**Latest Versions**: hono@4.10.6, zod@4.1.12, valibot@1.1.0\n\n---\n\n## Quick Start (5 Minutes)\n\n### Install\n\n```bash\nbun add hono@4.10.6  # preferred\n# or: bun add hono@4.10.6\n```\n\n**Why Hono:**\n- **Fast**: Built on Web Standards, runs on any JavaScript runtime\n- **Lightweight**: ~10KB, no dependencies\n- **Type-safe**: Full TypeScript support with type inference\n- **Flexible**: Works on Cloudflare Workers, Deno, Bun, Node.js, Vercel\n\n### Basic App\n\n```typescript\nimport { Hono } from 'hono'\n\nconst app = new Hono()\n\napp.get('\u002F', (c) => {\n  return c.json({ message: 'Hello Hono!' })\n})\n\nexport default app\n```\n\n**CRITICAL:**\n- Use `c.json()`, `c.text()`, `c.html()` for responses\n- Return the response (don't use `res.send()` like Express)\n- Export app for runtime\n\n### Add Validation\n\n```bash\nbun add zod@4.1.12 @hono\u002Fzod-validator@0.7.4\n```\n\n```typescript\nimport { zValidator } from '@hono\u002Fzod-validator'\nimport { z } from 'zod'\n\nconst schema = z.object({\n  name: z.string(),\n  age: z.number(),\n})\n\napp.post('\u002Fuser', zValidator('json', schema), (c) => {\n  const data = c.req.valid('json')\n  return c.json({ success: true, data })\n})\n```\n\n---\n\n## Critical Rules\n\n### Always Do\n\n✅ **Return responses** from handlers (c.json, c.text, c.html, etc.)\n\n✅ **Use c.req.valid('source')** after validation middleware to get typed data\n\n✅ **Export app** for deployment (Cloudflare Workers, Bun, Deno, Node.js)\n\n✅ **Use validation middleware** (zValidator, vValidator) for type-safe request data\n\n✅ **Call await next()** in middleware to pass control to next handler\n\n✅ **Use HTTPException** for expected errors (returns proper HTTP status)\n\n✅ **Use template tag validators** (zValidator, vValidator) not hooks\n\n✅ **Define context types** for custom variables (`Hono\u003C{ Variables: { ... } }>`)\n\n✅ **Use sub-apps** (app.route()) for organizing large APIs\n\n✅ **Type your RPC routes** (`export type AppType = typeof routes`) for client\n\n### Never Do\n\n❌ **Never forget to return** response from handlers\n\n❌ **Never use req.json() directly** without validation - use c.req.valid()\n\n❌ **Never mix validation hooks** with middleware - use middleware only\n\n❌ **Never forget await next()** in middleware - breaks middleware chain\n\n❌ **Never use res.send()** - not available (use c.json(), c.text(), etc.)\n\n❌ **Never skip error handling** - use app.onError() for global handler\n\n❌ **Never access unvalidated data** after validation middleware\n\n❌ **Never use blocking operations** in middleware - breaks async chain\n\n❌ **Never hardcode origins** in CORS - use environment variables\n\n❌ **Never skip type exports** for RPC - client won't have types\n\n---\n\n## Top 5 Errors (See references\u002Ftop-errors.md for all 12)\n\n### Error #1: Middleware Response Not Typed\n**Problem**: Middleware returns response but route handler still executes\n**Solution**: Don't return from middleware if you want chain to continue - only set variables\n```typescript\n\u002F\u002F ❌ Wrong - breaks chain\napp.use('*', (c) => {\n  return c.json({ error: 'Unauthorized' }, 401)\n})\n\n\u002F\u002F ✅ Correct - throw HTTPException instead\napp.use('*', (c, next) => {\n  if (!isAuthorized) {\n    throw new HTTPException(401, { message: 'Unauthorized' })\n  }\n  await next()\n})\n```\n\n### Error #2: Validation Hook vs Middleware Confusion\n**Problem**: Using validation hooks instead of middleware\n**Solution**: Always use middleware validators (zValidator, vValidator)\n```typescript\n\u002F\u002F ❌ Wrong - hooks deprecated\napp.post('\u002Fuser', (c) => {\n  const data = c.req.json\u003CUser>() \u002F\u002F No runtime validation!\n})\n\n\u002F\u002F ✅ Correct - middleware with runtime validation\napp.post('\u002Fuser', zValidator('json', schema), (c) => {\n  const data = c.req.valid('json') \u002F\u002F Validated & typed!\n})\n```\n\n### Error #3: Missing await next() in Middleware\n**Problem**: Middleware doesn't call next(), breaking chain\n**Solution**: Always call await next() unless returning early\n```typescript\n\u002F\u002F ❌ Wrong - chain broken\napp.use('*', (c) => {\n  console.log('Log')\n  \u002F\u002F Missing await next()!\n})\n\n\u002F\u002F ✅ Correct\napp.use('*', async (c, next) => {\n  console.log('Log')\n  await next()\n})\n```\n\n### Error #4: Context Variable Type Inference\n**Problem**: c.get() and c.set() not typed\n**Solution**: Define Variables type in Hono constructor\n```typescript\n\u002F\u002F ❌ Wrong - no types\nconst app = new Hono()\nc.set('user', { id: '123' }) \u002F\u002F Not typed\nconst user = c.get('user') \u002F\u002F any\n\n\u002F\u002F ✅ Correct - typed\ntype Variables = {\n  user: { id: string; name: string }\n}\nconst app = new Hono\u003C{ Variables: Variables }>()\nc.set('user', { id: '123', name: 'Alice' })\nconst user = c.get('user') \u002F\u002F Fully typed!\n```\n\n### Error #5: RPC Type Inference Not Working\n**Problem**: Client doesn't have types from server routes\n**Solution**: Export AppType and use hc\u003CAppType>\n```typescript\n\u002F\u002F Server\nconst routes = app.get('\u002Fusers', (c) => c.json([]))\nexport type AppType = typeof routes \u002F\u002F Export this!\n\n\u002F\u002F Client\nimport { hc } from 'hono\u002Fclient'\nimport type { AppType } from '.\u002Fserver'\n\nconst client = hc\u003CAppType>('http:\u002F\u002Flocalhost:8787') \u002F\u002F Fully typed!\n```\n\n**Load `references\u002Ftop-errors.md` for all 12 errors with detailed solutions.**\n\n---\n\n## Common Use Cases\n\n### Use Case 1: Basic REST API\n**When**: Simple CRUD operations\n**Quick Pattern**:\n```typescript\napp.get('\u002Fusers', (c) => c.json({ users: [] }))\napp.post('\u002Fusers', (c) => c.json({ created: true }))\napp.get('\u002Fusers\u002F:id', (c) => c.json({ user: {} }))\napp.put('\u002Fusers\u002F:id', (c) => c.json({ updated: true }))\napp.delete('\u002Fusers\u002F:id', (c) => c.json({ deleted: true }))\n```\n**Load**: `references\u002Fsetup-guide.md` → Complete Example\n\n### Use Case 2: Request Validation (Zod)\n**When**: Need type-safe request validation\n**Quick Pattern**:\n```typescript\nimport { zValidator } from '@hono\u002Fzod-validator'\nimport { z } from 'zod'\n\napp.post('\u002Fuser',\n  zValidator('json', z.object({\n    name: z.string(),\n    email: z.string().email(),\n  })),\n  (c) => {\n    const data = c.req.valid('json') \u002F\u002F Typed!\n    return c.json(data)\n  }\n)\n```\n**Load**: `references\u002Fvalidation-libraries.md`\n\n### Use Case 3: Type-Safe RPC\n**When**: Full-stack TypeScript with shared types\n**Load**: `references\u002Frpc-guide.md` + `templates\u002Frpc-pattern.ts`\n\n### Use Case 4: Middleware Composition\n**When**: Authentication, logging, rate limiting\n**Load**: `references\u002Fmiddleware-catalog.md` + `templates\u002Fmiddleware-composition.ts`\n\n### Use Case 5: Custom Context Variables\n**When**: Share data between middleware and routes\n**Load**: `templates\u002Fcontext-extension.ts`\n\n---\n\n## When to Load References\n\n**Load `references\u002Fsetup-guide.md` when**:\n- User needs complete setup walkthrough\n- User asks about deployment to different runtimes\n- User needs CRUD API example\n- User wants to try alternative validators (Valibot, ArkType, Typia)\n\n**Load `references\u002Ftop-errors.md` when**:\n- Encountering any of the 12 documented errors\n- User has middleware type issues\n- User confused about validation hooks vs middleware\n- User needs troubleshooting or debugging\n\n**Load `references\u002Fcommon-patterns.md` when**:\n- User asks for code examples or best practices\n- User needs route grouping, error handling, file upload patterns\n- User wants streaming, WebSocket, or pagination examples\n\n**Load `references\u002Fmiddleware-catalog.md` when**:\n- User needs built-in middleware (cors, logger, jwt, cache, compress, etag)\n- User wants to create custom middleware\n- User asks about authentication or authorization\n\n**Load `references\u002Frpc-guide.md` when**:\n- User building full-stack TypeScript app\n- User wants type-safe client\u002Fserver communication\n- User asks about hono\u002Fclient or RPC patterns\n\n**Load `references\u002Fvalidation-libraries.md` when**:\n- User comparing Zod vs Valibot vs ArkType vs Typia\n- User needs validation examples for each library\n- User asks about performance or bundle size\n\n---\n\n## Configuration Reference\n\n### Minimal Configuration\n\n```typescript\nimport { Hono } from 'hono'\n\nconst app = new Hono()\n\napp.get('\u002F', (c) => c.json({ message: 'Hello' }))\n\nexport default app\n```\n\n### Production Configuration\n\n```typescript\nimport { Hono } from 'hono'\nimport { cors } from 'hono\u002Fcors'\nimport { logger } from 'hono\u002Flogger'\nimport { HTTPException } from 'hono\u002Fhttp-exception'\n\ntype Variables = {\n  user: { id: string; name: string }\n  requestId: string\n}\n\nconst app = new Hono\u003C{ Variables: Variables }>()\n\n\u002F\u002F Global middleware\napp.use('*', logger())\napp.use('*', async (c, next) => {\n  c.set('requestId', crypto.randomUUID())\n  await next()\n})\n\napp.use('*', cors({\n  origin: process.env.ALLOWED_ORIGINS?.split(',') || [],\n  credentials: true,\n}))\n\n\u002F\u002F Routes\napp.route('\u002Fapi', apiRoutes)\n\n\u002F\u002F Global error handler\napp.onError((err, c) => {\n  if (err instanceof HTTPException) {\n    return c.json(\n      { error: err.message },\n      err.status\n    )\n  }\n\n  console.error(err)\n  return c.json(\n    { error: 'Internal Server Error' },\n    500\n  )\n})\n\n\u002F\u002F 404 handler\napp.notFound((c) => {\n  return c.json({ error: 'Not Found' }, 404)\n})\n\nexport default app\n```\n\n---\n\n## Using Bundled Resources\n\n### References (references\u002F)\n\n- **setup-guide.md** - Complete 6-step setup (install → deploy)\n- **top-errors.md** - All 12 errors with solutions\n- **common-patterns.md** - 7 production patterns (RPC, middleware, error handling, file upload)\n- **middleware-catalog.md** - Built-in middleware reference (cors, logger, jwt, cache)\n- **rpc-guide.md** - Type-safe RPC client\u002Fserver guide\n- **validation-libraries.md** - Comparison of Zod, Valibot, ArkType, Typia\n\n### Templates (templates\u002F)\n\n- **routing-patterns.ts** - Route examples (params, query, wildcard, grouping)\n- **validation-zod.ts** - Zod validation examples\n- **validation-valibot.ts** - Valibot validation examples\n- **middleware-composition.ts** - Auth, rate limiting, logging middleware\n- **error-handling.ts** - HTTPException and global error handler\n- **context-extension.ts** - Custom context variables\n- **rpc-pattern.ts** - RPC server setup\n- **rpc-client.ts** - RPC client usage\n- **package.json** - Dependencies configuration\n\n---\n\n## Dependencies\n\n**Required**:\n- `hono@^4.10.2` - Core framework\n\n**Choose ONE validator** (recommended):\n- `zod@^4.1.12` + `@hono\u002Fzod-validator@^0.7.4` (most popular)\n- `valibot@^1.1.0` + `@hono\u002Fvalibot-validator@^0.5.3` (smaller bundle)\n- `arktype@^2.0.0` + `@hono\u002Farktype-validator@^0.1.0` (fastest runtime)\n- `typia@^7.0.0` + `@hono\u002Ftypia-validator@^0.1.0` (compile-time validation)\n\n**Optional**:\n- `@hono\u002Fnode-server` - Node.js adapter\n- `@cloudflare\u002Fworkers-types` - TypeScript types for Workers\n\n---\n\n## Official Documentation\n\n- **Hono**: https:\u002F\u002Fhono.dev\n- **GitHub**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fhono (17.8k ⭐)\n- **API Reference**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fapi\u002Fhono\n- **Routing**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fapi\u002Frouting\n- **Middleware**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fguides\u002Fmiddleware\n- **Validation**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fguides\u002Fvalidation\n- **RPC**: https:\u002F\u002Fhono.dev\u002Fdocs\u002Fguides\u002Frpc\n- **Examples**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fhono\u002Ftree\u002Fmain\u002Fexamples\n\n---\n\n## Comparison: Hono vs Alternatives\n\n| Feature          | Hono      | Express   | Fastify   |\n| ---------------- | --------- | --------- | --------- |\n| **Size**         | ~10KB     | ~200KB    | ~100KB    |\n| **TypeScript**   | ✅ Native  | ⚠️ Types  | ✅ Native  |\n| **Type Inference**| ✅ Full   | ❌ No     | ⚠️ Limited |\n| **RPC**          | ✅ Built-in| ❌ No     | ❌ No     |\n| **Edge Runtime** | ✅ Yes    | ❌ No     | ❌ No     |\n| **Validation**   | ✅ Plugin  | ⚠️ Manual | ✅ Plugin  |\n| **Speed**        | Very Fast | Fast      | Very Fast |\n\n**Recommendation**:\n- **Use Hono if**: TypeScript, edge runtime, full type inference, small bundle\n- **Use Express if**: Legacy Node.js app, large ecosystem needed\n- **Use Fastify if**: Node.js only, need fastest Node.js framework\n\n---\n\n## Production Examples\n\n**Verified working projects**:\n\n1. **Cloudflare Workers API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fcloudflare-workers\n2. **Bun REST API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fbun\n3. **Deno API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fdeno\n4. **Node.js API**: https:\u002F\u002Fgithub.com\u002Fhonojs\u002Fexamples\u002Ftree\u002Fmain\u002Fnodejs\n\n---\n\n## Secure Installation\n\nWhen installing Hono and middleware packages, follow supply chain security best practices:\n\n- **Block post-install scripts** — `npm config set ignore-scripts true` (or Bun: disabled by default)\n- **Cooldown period** — Wait 7 days for new package versions to be vetted by the community\n- **Audit before installing** — Run `socket package score npm \u003Cpkg>` or use `socket npm install \u003Cpkg>` to check packages\n\nLoad the `dependency-upgrade` skill for full security configuration including Socket CLI integration, cooldown setup, lockfile validation, and CI enforcement.\n\n## Complete Setup Checklist\n\n- [ ] Installed Hono (`bun add hono`)\n- [ ] Installed validator (Zod, Valibot, ArkType, or Typia)\n- [ ] Created basic app with routes\n- [ ] Added validation middleware to routes\n- [ ] Configured CORS for cross-origin requests\n- [ ] Added global error handler (app.onError)\n- [ ] Added 404 handler (app.notFound)\n- [ ] Configured context types for custom variables\n- [ ] Tested routes locally\n- [ ] Deployed to target runtime (Cloudflare, Bun, Deno, Node.js)\n\n---\n\n**Questions? Issues?**\n\n1. Check `references\u002Ftop-errors.md` for all 12 errors and solutions\n2. Review `references\u002Fsetup-guide.md` for complete setup walkthrough\n3. See `references\u002Fcommon-patterns.md` for production patterns\n4. Check `references\u002Fmiddleware-catalog.md` for built-in middleware\n5. See `references\u002Frpc-guide.md` for type-safe client\u002Fserver\n6. Check official docs: https:\u002F\u002Fhono.dev\n",{"name":5,"license":15,"metadata":24,"description":7},{"version":25,"keywords":26,"last_verified":46,"package_version":47,"errors_prevented":48,"templates_included":49,"references_included":50},"2.0.0",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45],"hono","hono routing","hono middleware","hono rpc","hono validator","zod validator","valibot validator","type-safe api","hono context","hono error handling","HTTPException","c.req.valid","middleware composition","hono hooks","typed routes","hono client","middleware response not typed","hono validation failed","hono rpc type inference","2025-11-21","4.10.6",12,9,6,"main","c475fc64e94e803b50d14a791dfee8853fbb2c5c","integrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory","https:\u002F\u002Fgithub.com\u002FElogic360","2026-11-08 22:21:22",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add Elogic360\u002Fsoftware-factory --skill hono-routing",{"tool":63,"command":64},"bunx","bunx skills add Elogic360\u002Fsoftware-factory --skill hono-routing",{"tool":66,"command":67},"pnpm","pnpm dlx skills add Elogic360\u002Fsoftware-factory --skill hono-routing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002FSKILL.md",true,[71,77,81,85,89,93,97,103,107,111,115,119,123,127,131,135],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fcommon-patterns.md","REFERENCE","参考文档",9711,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Freferences\u002Fcommon-patterns.md",{"path":78,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Fmiddleware-catalog.md",9661,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Freferences\u002Fmiddleware-catalog.md",{"path":82,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Frpc-guide.md",10459,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Freferences\u002Frpc-guide.md",{"path":86,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":87,"sourceHtmlUrl":88},"references\u002Fsetup-guide.md",6836,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Freferences\u002Fsetup-guide.md",{"path":90,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":91,"sourceHtmlUrl":92},"references\u002Ftop-errors.md",10821,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Freferences\u002Ftop-errors.md",{"path":94,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":95,"sourceHtmlUrl":96},"references\u002Fvalidation-libraries.md",7153,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Freferences\u002Fvalidation-libraries.md",{"path":98,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":101,"sourceHtmlUrl":102},"scripts\u002Fcheck-versions.sh","SCRIPT","脚本",1907,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Fscripts\u002Fcheck-versions.sh",{"path":104,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":105,"sourceHtmlUrl":106},"templates\u002Fcontext-extension.ts",10659,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Fcontext-extension.ts",{"path":108,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":109,"sourceHtmlUrl":110},"templates\u002Ferror-handling.ts",10214,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Ferror-handling.ts",{"path":112,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":113,"sourceHtmlUrl":114},"templates\u002Fmiddleware-composition.ts",10841,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Fmiddleware-composition.ts",{"path":116,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":117,"sourceHtmlUrl":118},"templates\u002Fpackage.json",779,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Fpackage.json",{"path":120,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":121,"sourceHtmlUrl":122},"templates\u002Frouting-patterns.ts",7152,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Frouting-patterns.ts",{"path":124,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":125,"sourceHtmlUrl":126},"templates\u002Frpc-client.ts",6799,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Frpc-client.ts",{"path":128,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":129,"sourceHtmlUrl":130},"templates\u002Frpc-pattern.ts",5217,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Frpc-pattern.ts",{"path":132,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":133,"sourceHtmlUrl":134},"templates\u002Fvalidation-valibot.ts",8612,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Fvalidation-valibot.ts",{"path":136,"resourceType":99,"resourceTypeDesc":100,"sizeBytes":137,"sourceHtmlUrl":138},"templates\u002Fvalidation-zod.ts",11306,"https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fintegrations\u002Fclaude-skills-secondsky\u002Fplugins\u002Fhono-routing\u002Fskills\u002Fhono-routing\u002Ftemplates\u002Fvalidation-zod.ts",[140,148,155,162,169,176],{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":144,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":19},"01M79G206MT3J6S0GY3C45P2KV","vss-summarize-video","Use to summarize a recorded video via the LVS summarization microservice (HITL-gated) with a VLM fallback. Not for report generation or live RTSP captioning.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-summarize-video\u002FSKILL.md",[],[],{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":144,"licenseFileUrl":6,"sourceHtmlUrl":152,"categories":153,"keywords":154,"publishedAt":19},"01M79G1WN63PGRE8CKD47WEBQ5","vss-setup-video-analytics-api","Use to deploy the vss-video-analytics-api REST service standalone (config-source, data-log bind, Elasticsearch, optional Kafka). Not for full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-video-analytics-api\u002FSKILL.md",[],[],{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":144,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":161,"publishedAt":19},"01M79G1S9F7VY3EF6H53PRP5AN","vss-setup-behavior-analytics","Use to deploy the vss-behavior-analytics service standalone (entrypoint, config-source, optional calibration). Not for the full warehouse deploy.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-setup-behavior-analytics\u002FSKILL.md",[],[],{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":144,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":19},"01M79G1N1S1Y27PFZPYMNK1MTQ","vss-search-archive","Use this skill to run top-level VSS fusion search on archived video, or to ingest video files \u002F RTSP streams for search. Do NOT use for ad-hoc visual Q&A (use vss-ask-video), live captioning (use vss-deploy-dense-captioning), or video summarization and reports (use vss-summarize-video).","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-search-archive\u002FSKILL.md",[],[],{"skillNo":170,"name":171,"nameZh":6,"description":172,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":144,"licenseFileUrl":6,"sourceHtmlUrl":173,"categories":174,"keywords":175,"publishedAt":19},"01M79G1H6WN0Q6C0VCAXCZX6B7","vss-query-analytics","Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-query-analytics\u002FSKILL.md",[],[],{"skillNo":177,"name":178,"nameZh":6,"description":179,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":144,"licenseFileUrl":6,"sourceHtmlUrl":180,"categories":181,"keywords":182,"publishedAt":19},"01M79G1DYPNXQS7QHZ0AAF5FX5","vss-manage-video-io-storage","Use to call the VIOS REST API (sensor list, timelines, clip extraction, snapshots, add\u002Fdelete sensors and streams). Not for VLM inference or search.","https:\u002F\u002Fgithub.com\u002FElogic360\u002Fsoftware-factory\u002Fblob\u002Fmain\u002Fskills\u002Fnvidia\u002Fvss-manage-video-io-storage\u002FSKILL.md",[],[]]