coapi-developerlisted

Help developers use and maintain CoApi, a Spring HTTP Interface client auto-configuration library for typed @HttpExchange proxies backed by reactive WebClient or synchronous RestClient. Use this skill when the user mentions CoApi, @CoApi, @EnableCoApi, @LoadBalanced, @HttpExchange, Spring HTTP Interface clients, Spring Boot auto-configuration for HTTP clients, reactive vs sync client mode, Spring Cloud LoadBalancer integration, or repository classes such as CoApiDefinition, CoApiFactoryBean, AutoCoApiRegistrar, EnableCoApiRegistrar, ClientMode, WebClientFactoryBean, RestClientFactoryBean, ReactiveHttpExchangeAdapterFactory, SyncHttpExchangeAdapterFactory, or properties such as coapi.mode, coapi.base-packages, and coapi.clients.
Ahoo-Wang/skills · ★ 3 · AI & Automation · score 76

Install: claude install-skill Ahoo-Wang/skills

# CoApi Developer Skill Use this skill to help with **CoApi** (`me.ahoo.coapi`), which turns Spring `@HttpExchange` interfaces into Spring beans with minimal setup. CoApi is Kotlin-first, supports Spring Boot 4.x / Spring Framework 7.x in the current codebase, and can create either reactive `WebClient` or synchronous `RestClient` proxies. ## How To Work 1. Identify the request type, then load only the needed reference file: - New client interface, application config, load balancing, or examples: read [references/usage.md](references/usage.md). - Architecture, module boundaries, annotations, mode selection, or implementation edits: read [references/concepts.md](references/concepts.md). - Tests, assertions, `ApplicationContextRunner`, integration tests, or MockK: read [references/testing.md](references/testing.md). - Startup failures, missing beans, client mode surprises, base URL issues, or load-balancer problems: read [references/troubleshooting.md](references/troubleshooting.md). 2. Prefer concise, working Kotlin snippets unless the user asks for Java. 3. Recommend the simplest CoApi-supported approach first, then name the tradeoff when another approach is valid. 4. If the request is outside CoApi's purpose, say so directly and route the user to the Spring tool that owns it. ## Essential Facts - Dependency: `implementation("me.ahoo.coapi:coapi-spring-boot-starter")`. - Main annotations: - `@CoApi(baseUrl = "...", serviceId = "...", name = "...")` marks an