AI Agent skills for Okapi — a modern, minimalist HTTP framework for Go built for simplicity, performance, and developer experience.
Skills are focused, single-purpose reference files that AI agents (Claude Code, Cursor, Copilot, etc.) can load to understand and work with the Okapi framework. Each skill lives in its own directory with a SKILL.md file containing the API surface, patterns, and examples for one specific topic.
| Skill | Description |
|---|---|
| overview | Project structure, core types, constructors, app configuration, server lifecycle |
| routing | HTTP methods, path parameters, generic handlers, route groups, route methods, fallbacks |
| route_definition | Declarative RouteDefinition struct, bulk registration, project organization patterns |
| request_binding | Struct tag binding (JSON, query, path, header, cookie, form), validation tags, formats |
| response | JSON/XML/YAML responses, file serving, structured responses, ResponseWriter extensions |
| error_handling | Abort methods, custom error handlers, RFC 7807 Problem Details |
| openapi | Swagger UI, ReDoc, Scalar, OpenAPI 3.0 / 3.1, webhooks, OAuth flows, DocBuilder |
| authentication | JWT auth, claims expression DSL, Basic auth, CORS configuration |
| middleware | Built-in middleware (Logger, RequestID, BasicAuth, JWT, BodyLimit, CORS), chaining, std-lib bridge |
| dynamic_routes | Runtime enable/disable of routes, groups, and docs; deprecation; hiding |
| sse_stream | Server-Sent Events, single events, channel streaming, serializers |
| websocket | WebSocket upgrade via the okapi-ws package, with Okapi and net/http |
| http_client | okapi/client fluent HTTP client, retries, middleware, decoders |
| testing | TestServer, TestContext, okapitest fluent client, assertions |
| cli | okapicli package, flags, struct-based config, subcommands, server lifecycle hooks |
| context | Data store, request inspection, parameters, cookies, templates, static files, TLS |
Add skills to your project by referencing them in your CLAUDE.md:
Read skills from https://github.com/jkaninda/okapi-skillsOr clone locally and point to specific skills:
git clone https://github.com/jkaninda/okapi-skills.git skills/okapiCopy the relevant SKILL.md files into your project's context or documentation directory. Each file is self-contained and can be loaded independently.
skills/
├── README.md # This file
├── SKILLS.md # Machine-readable index
├── overview/SKILL.md
├── routing/SKILL.md
├── route_definition/SKILL.md
├── request_binding/SKILL.md
├── response/SKILL.md
├── error_handling/SKILL.md
├── openapi/SKILL.md
├── authentication/SKILL.md
├── middleware/SKILL.md
├── dynamic_routes/SKILL.md
├── sse_stream/SKILL.md
├── websocket/SKILL.md
├── http_client/SKILL.md
├── testing/SKILL.md
├── cli/SKILL.md
└── context/SKILL.md
To add a new skill:
- Create a directory with a descriptive name (e.g.
metrics/) - Add a
SKILL.mdinside it with the API reference, types, and examples - Update
README.mdandSKILLS.mdwith the new entry
Keep skills focused on a single topic. Prefer code examples over prose.
MIT — see the Okapi repository for details.