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 开发

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

关于

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.

主要功能

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

使用场景

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

关于

主要功能

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

使用场景

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