kora-openapi-generator-serverlisted
Install: claude install-skill kora-projects/kora-skills
# Kora OpenAPI Generator — HTTP Server
> **Kora sub-skill — obey the [kora-v1 meta rules](../../SKILL.md) on every task:** **R0** ensure `.kora-agent/` docs+examples are cloned · **R1** read this sub-skill before writing code · **R2** Kora APIs only — no Spring/Micronaut/Quarkus, no invented annotations or config keys · **R3** journal any incorrect Kora usage. Add comments/Javadoc only if asked.
Generate a type-safe Kora HTTP server from an OpenAPI 3.x contract. The `kora`
generator emits the transport layer (controller, response wrappers, models); you
implement one generated `*ApiDelegate` interface with `@Component` and return the
generated sealed `*ApiResponses` records. The generated controller registers
routes automatically — never write `@HttpController`/`@HttpRoute` by hand for a
generated API, and never edit files under `build/generated/`.
All Kora artifacts inherit their version from the `kora-parent` BOM
(`ru.tinkoff.kora:kora-parent`, e.g. `1.2.19` in the example apps) — never pin a
version on an individual `ru.tinkoff.kora:*` dependency. The OpenAPI plugin
`org.openapi.generator` is pinned to `7.14.0`; other versions are not guaranteed
to be code-compatible.
## Quick Start
### 1. Dependencies
===! ":fontawesome-brands-java: `Java`"
```groovy title="build.gradle"
import org.openapitools.generator.gradle.plugin.tasks.GenerateTask
buildscript {
dependencies {
classpath("ru.tinkoff.kora:openapi-generator:$koraVersion")
}