What is the patterns-api-contracts skill for Claude Code?

It is a specialized capability that guides Claude Code in creating standardized, production-ready RESTful API designs and OpenAPI specifications.

Can I use this for existing (brownfield) APIs?

Yes, the skill includes logic to detect and align with existing base paths, authentication patterns, and naming conventions to ensure consistency.

Does this skill support OpenAPI 3.0?

Yes, the skill is specifically designed to generate and validate schemas following the OpenAPI 3.0.3 specification.

How does it help with error handling?

It provides a standardized framework for mapping business logic failures to appropriate HTTP status codes and machine-readable error formats.

RESTful API Contract Designer

Name: RESTful API Contract Designer
Author: deepeshBodh

bydeepeshBodh

•

API Development

Designs standardized RESTful API contracts using best practices for endpoint mapping, schema definition, and error handling.

About

The patterns-api-contracts skill is a specialized tool for Claude Code that enables the creation of high-quality, spec-first RESTful API designs. It streamlines the development process by mapping user actions to appropriate HTTP methods, defining rigorous OpenAPI 3.0.3 schemas, and establishing consistent error response patterns. Whether you are building a greenfield microservice or integrating with existing brownfield systems, this skill ensures your API contracts are scalable, readable, and traceable to functional requirements.

Key Features

Standardized HTTP error response patterns
7 GitHub stars
Brownfield API alignment and collision handling
Pagination and filtering logic design
OpenAPI 3.0.3 compliant schema generation
Comprehensive action-to-endpoint mapping

Use Cases

Refactoring legacy APIs to follow modern REST conventions
Documenting existing endpoints into a formal OpenAPI specification
Designing a new RESTful microservice from scratch

About

Key Features

Standardized HTTP error response patterns
7 GitHub stars
Brownfield API alignment and collision handling
Pagination and filtering logic design
OpenAPI 3.0.3 compliant schema generation
Comprehensive action-to-endpoint mapping

Use Cases

Refactoring legacy APIs to follow modern REST conventions
Documenting existing endpoints into a formal OpenAPI specification
Designing a new RESTful microservice from scratch