skills.rest
jaeyeonling
jaeyeonlingCOMMUNITY
Explore all skills by this author →
GitHub

api-design

Standardize REST API design and OpenAPI documentation across projects.

Updated Jan 24, 2026
Search Tags:#versioning#documentation#openapi#rest#api-design#http-status
One-click install
npx skills add https://github.com/jaeyeonling/opencode-kit --skill api-design-jaeyeonling
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/jaeyeonling/opencode-kit/tree/main/.opencode/skills/api-design
Command: npx skills add https://github.com/jaeyeonling/opencode-kit --skill api-design-jaeyeonling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design teams often struggle with inconsistent REST API patterns, versioning schemes, and unclear documentation, leading to integration challenges and wasted effort.

Core Features & Use Cases

  • Clear REST resource modeling, proper HTTP method semantics, and consistent status codes.
  • API versioning guidance (URL-based or header-based) and forward-/backward compatibility strategies for evolving services.
  • OpenAPI/Swagger documentation patterns and response schemas to enable predictable client integration.
  • Use Case: standardize API contracts across multiple microservices to reduce integration issues and accelerate onboarding.

Quick Start

Run the API design guide to structure and document your REST APIs across services.

Frequently Asked Questions about api-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to standardize REST API design across multiple microservices?▼

Standardizing REST API design across microservices requires applying consistent resource modeling, HTTP method semantics, and explicit status codes. This approach ensures predictable client integration and accelerates onboarding across services.

How do I choose between URL-based and header-based API versioning?▼

API versioning strategies like URL-based or header-based dictate how services evolve. Choosing the right versioning strategy ensures forward and backward compatibility while standardizing REST API contracts across evolving microservices.

How should I handle HTTP status codes and error handling in REST APIs?▼

HTTP status codes and error handling in REST APIs require explicit semantics. Applying consistent status codes and proper error response schemas enables predictable client integration and fulfills core REST principles.

How do I generate OpenAPI documentation for consistent REST API contracts?▼

Generating OpenAPI documentation involves defining response schemas and Swagger documentation patterns. This standardizes API contracts across microservices, reducing integration issues and enabling predictable client integration.

Can I use this REST API design guide for both public APIs and internal microservices?▼

Yes, this REST API design guide applies to both public APIs and internal microservices. It addresses resource modeling, versioning, error handling, and OpenAPI documentation to ensure consistent API patterns across projects.

Related Skills

Explore More Software Engineering Skills→
Fr-e-dFr-e-d
157

architecture-extract

Analyze project directory structures to generate architectural summaries.

Community
Basic
HouseGarofaloHouseGarofalo
3

openapi-swagger

Design, document, and generate APIs from OpenAPI and Swagger specifications.

Official
Advanced
calcosmiccalcosmic
9

rest-api

Audit REST API design and documentation for consistent endpoints, schemas, and errors.

Community
Advanced
LumenWipeLumenWipe
3

api-design-principles

Design REST and GraphQL APIs with resource-oriented modeling and HTTP semantics.

Official
Advanced