Skills
.Work. You
Rest

openapi-first

Community

Guarantee end-to-end API type safety.

Software Engineering#openapi#type-safety#spring-boot#code-generation#backend-frontend#api-contract
Authorymkz
Version1.0.0
Installs0

System Documentation

What problem does it solve?

OpenAPI-first development helps align backend and frontend teams by generating the OpenAPI contract from the backend and consuming it on the frontend to ensure type safety and contract accuracy.

Core Features & Use Cases

  • Backend generation of OpenAPI docs (openapi.json) from Spring Boot with Springdoc.
  • Frontend code generation of TypeScript types and API clients using @hey-api/openapi-ts.
  • Single source of truth for API contracts, enabling safe end-to-end development across services.

Quick Start

Configure backend OpenAPI generation first, then run the frontend generator to produce type-safe clients.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: openapi-first
Download link: https://github.com/ymkz/demo-monorepo/archive/main.zip#openapi-first

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.