AI Agent skills for Okapi — a modern, minimalist HTTP web framework for Go inspired by FastAPI.
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 |
| route_definition | Declarative RouteDefinition struct, bulk registration, project organization patterns |
| request_binding | Struct tag binding (JSON, query, path, header, cookie, form), validation tags |
| response | JSON/XML/YAML responses, file serving, structured responses, error handling, RFC 7807 |
| openapi | Swagger UI, ReDoc, route documentation options, DocBuilder, OpenAPI configuration |
| authentication | JWT auth, claims expression DSL, Basic auth, CORS configuration |
| middleware | Built-in middleware, global/per-route/per-group middleware, chaining pattern |
| sse_stream | Server-Sent Events, single events, channel streaming, serializers |
| testing | TestServer, TestContext, okapitest fluent client, assertions |
| cli | okapicli package, flags, struct-based config, subcommands, server lifecycle |
| 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
├── openapi/SKILL.md
├── authentication/SKILL.md
├── middleware/SKILL.md
├── sse_stream/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.
websocket/) - Add a
SKILL.mdinside it with the API reference, types, and examples - Update
SKILLS.mdwith the new entry
Keep skills focused on a single topic. Prefer code examples over prose.
MIT — see the Okapi repository for details.